textareaNN 2 IE 3 DOM 1

L'objet textarea représente l'élément textarea et est utilisé comme contrôle de formulaire. Cet objet est le principal moyen d'amener un utilisateur à entrer plusieurs lignes de texte à soumettre au serveur. Remarque: La propriété innerHTML n´est pas disponible dans la version Macintosh de Microsoft Internet Explorer 4. Seul un nombre limité de propriétés et méthodes répertoriées ci-dessous sont disponibles dans les anciens navigateurs qui ne prennent pas en charge l´adressage de tous les éléments HTML (avant IE 4 et Netscape 6). IE 5 et les versions ultérieures prennent en charge la méthode doScroll() pour cet objet.

 
Equivalent HTML
 
<textarea>
 
Référence de modèle d'objet
 
[window.]document.formName.elementName
[window.]document.forms[i].elements[j]
[window.]document.getElementById("elementID")
 
Propriétés spécifiques à l´objet
 
colsdataFlddataSrcdefaultValueform
namereadOnlyrowsstatustype
valuewrap
 
Méthodes spécifiques à l´objet
 
createTextRange()handleEvent()select()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet
 
GestionnaireNNIEDOM
onblur23s.o
onchange23s.o
onfocus23s.o
onkeydown44s.o
onkeypress44s.o
onkeyup44s.o
onscrolls.o4s.o
onselect23s.o
colsNN 6 IE 4 DOM 1

Lecture/écriture

Spécifie la largeur de l'espace modifiable de l'élément textarea. Cette valeur désigne le nombre de caractères d'une police non proportionnelle qui doivent s'afficher dans la largeur de l´élément. Lorsque la taille de police peut-être modifiée à l´aide de feuilles de style, la largeur réelle est modifiée en conséquence.

 
Exemple
 
document.forms[0].comments.cols = 60;
 
Valeur

Nombre entier.

 
Par défaut

Varie selon le navigateur et le système d'exploitation.

dataFldNN s.o. IE 4 DOM s.o.

Lecture/écriture

Utilisé avec la liaison de données IE pour associer le nom d'une colonne d'une source de données distante à la propriété value de l'objet textarea. Vous devez également définir un attribut datasrc pour l'élément. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données. Fonctionne uniquement avec les sources de données de fichiers sources dans IE 5/Mac.

 
Exemple
 
document.myForm.myTextArea.dataFld = "description";
 
Valeur

Identifiant de la colonne de la source de données, sensible à la casse.

 
Par défaut

Aucune.

dataSrcNN s.o. IE 4 DOM s.o.

Lecture/écriture

Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour spécifier l´ID de l´élément object de la page qui charge l´objet de source de données pour l´accès distant aux données. Le contenu à extraire de la source de données est spécifié à l'aide de l'attribut datafld. Le paramétrage des deux propriétés dataFld et dataSrc sur des chaînes vides rompt la liaison entre l'élément et la source de données. Fonctionne uniquement avec les sources de données de fichiers sources dans IE 5/Mac.

 
Exemple
 
document.myForm.myTextArea.dataSrc = "DBSRC3";
 
Valeur

Identifiant de la source de données, sensible à la casse.

 
Par défaut

Aucune.

defaultValueNN 2 IE 3 DOM 1

Lecture seule

Spécifie le texte par défaut pour l´élément textarea, comme établi par le texte entre les balises de début et de fin dans le code source de la page.

 
Exemple
 
var txtAObj = document.forms[0].myTextArea;
if (txtAObj.value != txtAObj.defaultValue ) {
    ...
}
 
Valeur

Toute chaîne de texte.

 
Par défaut

Aucune.

filters[]NN s.o. IE 4 DOM s.o.

Renvoie un tableau de tous les objets filter que contient l´élément courant. Ne s´applique qu´aux objets éléments suivants: bdo , body , button , div , fieldset , img , input , marquee , rt , ruby , span , table , td , textarea et th . Voir l'objet filter pour la syntaxe de référencement.

 
Valeur

Tableau des références des objets filter .

 
Par défaut

Tableau de longueur zéro.

formNN 2 IE 3 DOM 1a

Lecture seule

Renvoie une référence à l'élément form qui contient l'élément courant. Lors du traitement d´un événement à partir de cet élément, la fonction de gestionnaire d´événements a automatiquement accès à l´élément select (en tant que propriété target ou srcElement de l´objet événement). En lisant la propriété form, le script peut facilement accéder à d´autres contrôles dans le même formulaire.

 
Exemple
 
var theForm = evt.srcElement.form;
 
Valeur

Référence de l'objet élément form.

 
Par défaut

Aucune.

nameNN 2 IE 3 DOM 1

Lecture/écriture

Identifiant associé au contrôle du formulaire. Lors de l'envoi du formulaire au serveur, la valeur de cette propriété est envoyée comme une moitié de la paire nom / valeur. Les noms sont masqués à la vue de l'utilisateur, les étiquettes de contrôle étant affectées par d'autres moyens, en fonction du type de contrôle. Les noms de contrôle de formulaire peuvent également être utilisés dans des instructions de script faisant référence à des objets. Bien que les normes modernes préfèrent l´attribut id, de nombreux navigateurs nécessitent encore qu´un attribut name soit affecté à un contrôle pour que la valeur de ce dernier puisse être envoyée.

 
Exemple
 
document.orderForm.myTextArea.name = "customerComment";
 
Valeur

Identifiant sensible à la casse, conforme aux règles de dénomination des identifiants: il ne peut pas contenir d'espace blanc ni de signe de ponctuation, à l'exception du caractère de soulignement, et ne peut pas commencer par un chiffre.

 
Par défaut

Aucune.

readOnlyNN 6 IE 4 DOM 1

Lecture/écriture

Détermine si l'élément de formulaire peut être modifié par l'utilisateur. Un script peut modifier un contrôle de formulaire dont la propriété readOnly est true, mais l'utilisateur ne peut pas en modifier le contenu.

 
Exemple
 
document.forms[0].myTextArea.readOnly = "true";
 
Valeur

Valeur booléenne: true | false.

 
Par défaut

false

rowsNN 6 IE 4 DOM 1

Lecture/écriture

Spécifie la hauteur de l'élément textarea en fonction du nombre de lignes de texte qui doivent s'afficher sans faire défiler l'écran. Cette valeur représente le nombre de lignes (avec une police non proportionnelle) qui doivent s'afficher dans la hauteur sans que la barre de défilement soit activée. Lorsque la taille de police peut-être modifiée à l´aide de feuilles de style, la hauteur réelle est modifiée en conséquence.

 
Exemple
 
document.forms[0].comments.rows = 6;
 
Valeur

Nombre entier.

 
Par défaut

2 (IE/Windows); 1 (IE/Macintosh); -1 (Netscape 6, ce qui signifie que l´attribut n´a pas été défini).

statusNN s.o. IE 4 DOM s.o.

Lecture/écriture

Implémentée dans IE, mais sans fonction pour l´objet textarea.

 
Valeur

Valeur booléenne: true | false ou null.

 
Par défaut

null

typeNN 3 IE 4 DOM 1

Lecture seule

Renvoie le type de l'élément contrôle de formulaire. La valeur renvoyée s'affiche en lettres minuscules. Il peut s´avérer nécessaire de parcourir successivement tous les éléments du formulaire à la recherche de types spécifiques à traiter (par exemple vider tous les contrôles de formulaire de type "textarea" sans modifier les autres contrôles).

 
Exemple
 
if (document.forms[0].elements[3].type == "textarea") {
    ...
}
 
Valeur

L'une des constantes suivantes (sous forme de chaîne): button | checkbox | file | hidden | image | password | radio | reset | select-multiple | select-one | submit | text | textarea.

 
Par défaut

textarea

valueNN 2 IE 3 DOM 1

Lecture/écriture

Fournit la valeur courante associée au contrôle de formulaire envoyé avec la paire nom/valeur de cet élément. Toutes les valeurs sont des chaînes.

 
Exemple
 
var comment = document.forms[0].myTextArea.value;
 
Valeur

Chaîne.

 
Par défaut

Aucune.

wrapNN s.o. IE 4 DOM s.o.

Lecture/écriture

Détermine si le navigateur doit insérer des sauts de lignes automatiques dans le texte d'un élément textarea et s'il faut convertir les sauts de ligne automatiques du texte soumis au serveur en sauts de ligne manuels. La valeur hard insère les sauts de ligne automatiques qu'elle convertit en caractères CR-LF dans la valeur transmise au serveur. La valeur soft insère les sauts de lignes automatiques sans toutefois les convertir en caractères CR-LF dans le texte envoyé avec le formulaire. La valeur off désactive l'insertion automatique de saut de ligne.

 
Exemple
 
document.forms[0].comments.wrap = "soft";
 
Valeur

L'une des constantes suivantes sous forme de chaîne: hard | off | soft.

 
Par défaut

soft

createTextRange()NN s.o. IE 4 (Win) DOM s.o.

Crée un objet TextRange à partir du contenu de l'objet textarea. Voir l'objet TextRange pour plus de détails.

 
Valeur renvoyée

Objet TextRange.

handleEvent()NN |4| IE s.o. DOM n/a

handleEvent(événement)

Indique à l'objet qu´il doit accepter et traiter l'événement dont les spécifications sont passées à la méthode sous forme de paramètre. Pour pouvoir traiter l'événement, l'objet doit disposer d'un gestionnaire d'événements pour ce type d'événement. Navigator 4 uniquement.

 
Paramètres
 
  • Objet event de Navigator 4.
 
Valeur renvoyée

Aucune.

select()NN 2 IE 3 DOM 1

Sélectionne tout le texte affiché dans l'élément formulaire. Pour placer le pointeur d´insertion à un emplacement spécifique dans un élément textarea dans IE, reportez-vous à l´objet TextRange.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.

focus()NN 2 IE 3 DOM 1

Donne l'activation à partir de l'objet courant, moment auquel l'événement onfocus de l'objet se déclenche. Remarque: La plage d'éléments capables d'activation et de fondu (l'événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l'attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode focus() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea .

 

Pour activer une zone de texte et présélectionner tout le texte de la zone, utilisez la séquence des méthodes focus() et select() sur l'élément. Si cette séquence doit se produire après un changement de fenêtre (par exemple, après la fermeture d'une boîte de dialogue d'alerte), placez les méthodes dans une fonction indépendante et invoquez cette méthode par le biais de la méthode setTimeout() après la méthode alert() de la boîte de dialogue. Cela permet à IE pour Windows d'exécuter les instructions dans l'ordre correct.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.

accessKeyNN s.o. IE 4 DOM 1

Lecture/écriture

Une seule touche de caractère qui active un élément (dans certains navigateurs) ou active un contrôle de formulaire ou une action de lien. Le navigateur et le système d'exploitation déterminent si l'utilisateur doit appuyer sur une touche de modification (par exemple Ctrl, Alt ou Commande) en même temps que sur la touche d'accès pour activer le lien. Dans IE 5 pour Windows et versions ultérieures ainsi que Netscape 6, il doit obligatoirement s'agir de la touche Alt et celle-ci est insensible à la casse. Dans IE 5 pour Macintosh et versions ultérieures ainsi que Netscape 6, il doit obligatoirement s'agir de la touche Ctrl.

 

Bien que répertorié ici comme attribut largement partagé, ce n'est pas toujours le cas dans toutes les implémentations. Netscape 6 (par le biais du DOM W3C) reconnaît cette propriété pour les éléments suivants uniquement: a , area , button , input , label , legend et textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , object , select , span , table et td (mais supprime label et legend ). IE 5 ajoute tout autre élément affichable, mais attention: à l'exception de l'élément input et d'autres éléments ayant trait aux formulaires, vous devez aussi affecter un attribut tabindex ou une propriété tabIndex à l'élément dans IE 5 et versions ultérieures (même s'il ne s'agit que d'une valeur de zéro pour tous) pour permettre à la combinaison de touches d'accélération d'activer l'élément. A partir de Netscape 7, Netscape ne modifie pas le comportement de l'interface utilisateur si un script modifie la valeur de la propriété.

 
Exemple
 
document.links[3].accessKey = "n";
 
Valeur

Caractère unique du clavier alphanumérique (y compris les signes de ponctuation).

 
Par défaut

Une chaîne vide.

clientHeight, clientWidthNN 7 IE 4 DOM s.o.

Lecture seule

En gros, ces propriétés fournissent la hauteur et la largeur du contenu de l'élément, mais avec quelques variations mineures dans le remplissage de l'élément selon les versions du système d'exploitation de Microsoft Internet Explorer et les modes de compatibilité contrôlés par la déclaration DOCTYPE . Non disponible pour certains types d'éléments dans IE pour Macintosh. Pour Netscape 7, les valeurs sont de zéro, sauf quand le contenu d'un élément dépasse de la zone visible, auquel cas les valeurs révèlent les dimensions de la zone visible (par exemple, la zone de contenu de la fenêtre du navigateur pour l'élément document.body ). Pour en savoir plus, reportez-vous à la section 9.2 au début de ce chapitre.

 
Exemple
 
var midHeight = document.body.clientHeight/2;
 
Valeur

Valeur en pixels (nombre entier).

 
Par défaut

0

clientLeft, clientTopNN s.o. IE 4 DOM s.o.

Lecture seule

En gros, ces propriétés fournissent les coordonnées gauche et supérieure du contenu de l'élément dans le cadre qui inclut le remplissage de l'élément, mais avec des variations mineures selon les versions du système d'exploitation de Microsoft Internet Explorer. Non disponible pour certains types d'éléments dans IE pour Macintosh. Pour en savoir plus, reportez-vous à la section 9.2 au début du présent chapitre. Des informations plus utiles sur le positionnement des éléments internes proviennent généralement des propriétés offsetLeft et offsetTop (y compris dans Netscape 6). Pour les éléments positionnés par CSS (y compris la modification de la position d'un élément), utilisez les propriétés de l'objet style , telles que left et top , et (dans IE uniquement) pixelLeft et pixelTop .

 
Valeur

Valeur en pixels (nombre entier).

 
Par défaut

0

disabledNN 6 IE 4 DOM 1

Lecture/écriture

Détermine si l'élément est disponible pour une action interactive de l'utilisateur. S'il est défini sur la valeur true , l'utilisateur ne peut pas activer ni modifier cet élément, qui apparaît généralement en grisé sur cette page. Cette propriété est disponible pour tous les objets éléments dans IE 5.5 pour Windows et versions ultérieures. Pour IE 4 et IE 5, elle ne s'applique qu'aux contrôles de formulaire, alors que Netscape 6 et versions ultérieures reconnaissent cette propriété pour les contrôles de formulaire et l'objet élément style . La paire désactivée nom  /  valeur d'un contrôle de formulaire n'est pas transmise avec le formulaire.

 
Exemple
 
document.getElementById("myButton").disabled = true;
 
Valeur

Valeur booléenne: true | false .

 
Par défaut

false

scrollHeight, scrollWidthNN 7 IE 4 DOM s.o.

Lecture seule

A l'origine, implémentées dans IE 4 pour les éléments qui défilaient ou influençaient le défilement d'un élément (body , button , caption , div , fieldset , legend , marquee et textarea ), ces propriétés renvoient les dimensions en pixels d'un élément, y compris les éléments plus grands que la zone visible de la fenêtre du navigateur. Elles sont donc différentes des propriétés clientHeight et clientWidth pour les éléments pouvant défiler, qui renvoient seulement les dimensions des portions visibles de l'élément. Cependant, IE pour Macintosh interprète différemment le but des propriétés de défilement et renvoie les dimensions de la portion visible.

 

A partir de Microsoft Internet Explorer 5 pour Windows, tous les éléments HTML ont ces propriétés et les valeurs pour les éléments ne défilant pas, sont les mêmes que celles des propriétés offsetHeight et offsetWidth . Netscape 7 implémente ces propriétés pour tous les éléments et renvoie la hauteur et la largeur de l'élément, visible ou non. Pour les éléments clés tels que body , il est important de retenir que ces propriétés peuvent être interprétées différemment et sont donc susceptibles de perturber l'opération sur différentes plates-formes.

 
Exemple
 
var midPoint = document.body.scrollHeight/2;
 
Valeur

Nombre entier positif ou zéro.

 
Par défaut

Aucune.

scrollLeft, scrollTopNN 7 IE 4 DOM s.o.

Lecture/écriture

Fournit la distance en pixels existant entre le côté gauche ou supérieur réel du contenu physique de l'élément et le côté gauche ou supérieur de la partie visible du contenu. Le paramétrage de ces propriétés permet d'utiliser un script pour ajuster le défilement du contenu à l'intérieur d'un conteneur capable de défilement, tel que du texte dans un élément textarea ou un document entier dans une fenêtre ou un cadre de navigateur. Si personne ne fait défiler le contenu, les deux valeurs sont égales à zéro. Si la valeur de la propriété scrollTop est  15, le document défile de 15  pixels dans la fenêtre; la propriété scrollLeft n'est pas affectée, sauf si elle est modifiée. Les valeurs de ces propriétés changent au fur et à mesure que l'utilisateur modifie la position des barres de défilement. Cela est important pour certaines tâches de positionnement basées sur les événements dans IE pour Windows, car le système de coordonnées pour les mesures de décalage d'événements est fonction de la zone visible d'une page dans la fenêtre du navigateur. Vous devez ajouter les facteurs de défilement document.body pour aligner les coordonnées d'événements avec les positions du contenu du corps (reportez-vous à l'exemple de glissement d'un élément dans le chapitre 6). A partir de Microsoft Internet Explorer 5 pour Windows, les propriétés scrollLeft et scrollTop sont disponibles pour tous les objets éléments HTML, mais les valeurs pour les éléments qui ne défilent pas sont de zéro.

 
Exemple
 
document.body.scrollTop = 40;
 
Valeur

Nombre entier positif ou zéro.

 
Par défaut

0

tabIndexNN 6 IE 4 DOM 1

Lecture/écriture

Nombre indiquant la position de cet élément dans l'ordre de tabulation des éléments pouvant être activés dans le document. L'ordre de tabulation suit un ensemble de règles très strictes. Les éléments dont les valeurs affectées aux propriétés tabIndex diffèrent de zéro sont les premiers activés lorsqu'un utilisateur commence à tabuler dans une page. Le premier élément activé est celui dont l'attribut tabIndex a la valeur la plus faible, et ainsi de suite, dans l'ordre croissant, quel que soit l'emplacement physique des éléments sur la page ou dans le document. Si deux éléments ont un attribut tabIndex de valeur identique, c'est celui qui apparaît le premier dans le document qui est activé d'abord. Viennent ensuite les éléments qui ne prennent pas en charge la propriété tabIndex ou dont la valeur est zéro. Ces éléments sont activés dans l'ordre où ils apparaissent dans le document.

 

Le DOM W3C et Netscape 6 limitent la propriété tabIndex aux objets éléments suivants: a , area , button , input , object , select , textarea . A cette liste, IE 4 ajoute applet , body , div , embed , isindex , marquee , span , table , et td . IE 5 ajoute tout autre élément affichable. Une valeur négative dans IE (uniquement) supprime un élément de la séquence de tabulation.

 

Les liens et les ancres ne sont pas activables à l'aide de la touche de tabulation dans la version Macintosh de Microsoft Internet Explorer 4 et la propriété tabIndex des objets éléments a est donc ignorée dans cette version.

 
Exemple
 
document.getElementById("link3").tabIndex = 6;
 
Valeur

Nombre entier.

 
Par défaut

0

blur()NN 2 IE 3 DOM 1

Supprime l'activation de l'objet courant, moment auquel l'événement onblur de l'objet se déclenche. Remarque: La plage d'éléments capables d'activation et de fondu (l'événement et la méthode) est limitée dans tous les navigateurs sauf dans les versions les plus récentes de Microsoft Internet Explorer (reportez-vous à l'attribut tabindex dans le chapitre 8). Pour une plus grande fiabilité en ce qui concerne la compatibilité ascendante, appliquez la méthode blur() à des éléments qui sont activables de façon évidente, tels que les éléments input et textarea . L'affectation de l'attribut onfocus="this.blur();" à un élément input texte, par exemple, est une façon grossière mais efficace en matière de compatibilité ascendante de désactiver un champ pour les navigateurs ne fournissant pas de véritable désactivation d'éléments.

 

Utilisez les méthodes blur() et focus() avec modération sur la même page. Vous pouvez déclencher des boucles d'activation et de fondu infinies par accident si des boîtes de dialogue d'alerte sont impliquées à un moment ou à un autre. De plus, sachez que lorsque vous invoquez la méthode blur() sur un objet, un autre objet (peut-être l'objet window ) reçoit un événement onfocus .

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.