<TEXTAREA> | NN tous IE tous HTML tous | |||||||||||||||||||||||
<TEXTAREA>...</TEXTAREA> | Balise de fin HTML : obligatoire | |||||||||||||||||||||||
L'élément textarea est un contrôle de saisie de texte sur plusieurs lignes; il est principalement utilisé dans un élément form (obligatoire dans Navigator 4 et versions ultérieures). Contrairement à l'élément input de type texte, l'élément textarea peut être dimensionné pour accepter plusieurs lignes de texte. Les versions récentes des navigateurs prennent en charge le renvoi à la ligne, et l'utilisateur peut saisir des sauts de ligne (combinaison des caractères 13 et 10 en ASCII décimal) dans la zone de texte. Lorsqu'un élément textarea figure dans un formulaire envoyé au serveur, il est transmis sous forme d'une paire nom / valeur dans laquelle la valeur est le contenu de la zone de texte (et dans laquelle l'attribut name doit avoir été défini). Le programme CGI implanté sur le serveur doit être capable de traiter d'éventuels sauts de ligne dans le texte. Si vous désirez que du texte soit déjà affiché dans l'élément textarea lors de son chargement, ce texte doit être inséré entre les balises de début et de fin; sinon, aucun caractère affichable ne doit apparaître dans le code source entre ces balises. Si une légende doit accompagner l'élément textarea, elle doit être placée avant ou après cet élément; avec les navigateurs récents, cette légende peut être insérée dans un élément label pour des raisons de structuration (facultatif pour les navigateurs les plus récents). |
||||||||||||||||||||||||
Exemple | ||||||||||||||||||||||||
<TEXTAREA rows="5" cols="60" name="notes">Use this area for extra notes. </TEXTAREA> |
||||||||||||||||||||||||
Référence de modèle d'objet | ||||||||||||||||||||||||
[window.]document.formName.elementName [window.]document.forms[i].elements[j] [window.]document.getElementById(elementID) |
||||||||||||||||||||||||
Attributs spécifiques à l'élément | ||||||||||||||||||||||||
|
||||||||||||||||||||||||
Attributs du gestionnaire d´événements spécifiques à l´élément | ||||||||||||||||||||||||
|
accesskey | NN 6 (voir text) IE 4/5 HTML 4 (voir text) |
accesskey="character" | Facultatif |
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 4 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 l'attribut accesskey soit répertorié ici comme attribut largement partagé, ce n'est pas toujours le cas dans toutes les implémentations. HTML 4 et Netscape 6 ne reconnaissent cet attribut que pour les éléments suivants: 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 à 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. |
|
Exemple | |
<a href="http://www.megacorp.com/toc.html" accesskey="t">Table of Contents</a> <h2 class="subsection" accesskey="2" tabindex="0">Part Two</h2> |
|
Valeur | |
Caractère simple repris dans la table de caractères définie pour le document. |
|
Par défaut | |
Aucune. |
|
Référence de modèle d'objet | |
[window.]document.links[i].accessKey [window.]document.anchors[i].accessKey [window.]document.formName.elementName.accessKey [window.]document.forms[i].elements[j].accessKey [window.]document.getElementById(elementID).accessKey |
cols | NN tous IE tous HTML tous |
cols="columnCount" | Facultatif |
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. Si le navigateur prend en charge les tailles de police des feuilles de style, la largeur réelle change en conséquence. |
|
Exemple | |
<TEXTAREA cols="40">...</TEXTAREA> |
|
Valeur | |
Tout entier positif. |
|
Par défaut | |
Varie selon le navigateur et le système d'exploitation. |
|
Référence de modèle d'objet | |
[window.]document.formName.elementName.cols [window.]document.forms[i].elements[j].cols [window.]document.getElementById(elementID).cols |
datafld | NN s.o. IE 4 HTML s.o. |
datafld="columnName" | Facultatif |
Utilisé avec la fonction de liaison de données de Microsoft Internet Explorer pour associer un nom de colonne provenant d'une source de données distante au contenu de l'élément textarea. Vous devez également définir un attribut datasrc pour l'élément. S'applique uniquement aux sources de données de fichier texte dans IE 5/Mac. |
|
Exemple | |
<TEXTAREA name="summary" datasrc="DBSRC3" datafld="summary"></TEXTAREA> |
|
Valeur | |
Identifiant sensible à la casse. |
|
Par défaut | |
Aucune. |
|
Référence de modèle d'objet | |
[window.]document.formName.elementName.dataFld [window.]document.forms[i].elements[j].dataFld [window.]document.getElementById(elementID).dataFld |
datasrc | NN s.o. IE 4 HTML s.o. |
datasrc="dataSourceName" | Facultatif |
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. S'applique uniquement aux sources de données de fichier texte dans IE 5/Mac. |
|
Exemple | |
<TEXTAREA name="summary" datasrc="DBSRC3" datafld="summary"></TEXTAREA> |
|
Valeur | |
Identifiant sensible à la casse. |
|
Par défaut | |
Aucune. |
|
Référence de modèle d'objet | |
[window.]document.formName.elementName.dataSrc [window.]document.forms[i].elements[j].dataSrc [window.]document.getElementById(elementID).dataSrc |
disabled | NN 6 IE 3 HTML 4 |
disabled | Facultatif |
Un élément textarea désactivé à l'aide de cet attribut ne peut pas être activé par l'utilisateur. Dans IE pour Windows et Netscape 6, un élément textarea désactivé ne peut pas être activé à l'aide de la touche de tabulation. La paire nom / valeur d'un élément désactivé n'est pas envoyée avec le formulaire. L'attribut disabled est de type booléen, ce qui signifie que sa simple présence dans le jeu d'attributs définit sa valeur comme true (vrai). Cette valeur peut également être modifiée par la suite à l'aide d'un script (voir l'objet textarea dans le chapitre 9). |
|
Exemple | |
<TEXTAREA disabled></TEXTAREA> |
|
Valeur | |
La présence de cet attribut désactive l'élément. |
|
Par défaut | |
false |
|
Référence de modèle d'objet | |
[window.]document.formName.elementName.disabled [window.]document.forms[i].elements[j].disabled [window.]document.getElementById(elementID).disabled |
lang | NN 3 IE 4 HTML 4 |
lang="languageCode" | Facultatif |
La langue utilisée pour le contenu et les valeurs d'attributs de l'élément. Un navigateur peut se servir de ces informations pour aider à l'affichage correct du contenu aussi bien que de détails comme le traitement des ligatures (lorsqu'elles sont prises en charge par une police particulière ou requises par une langue écrite), des guillemets et des traits d'union. D'autres applications et moteurs de recherche peuvent se servir de ces informations pour faciliter la sélection des dictionnaires utilisés pour la vérification orthographique et aider la création d'index. |
|
Exemple | |
<span lang="de">Deutsche Bundesbahn</span> |
|
Valeur | |
Code de langue insensible à la casse. |
|
Par défaut | |
Valeur par défaut du navigateur. |
|
Référence de modèle d'objet | |
[window.]document.getElementById(elementID).lang
|
name | NN tous IE tous HTML tous |
name="elementIdentifier" | Facultatif |
Si l'élément textarea fait partie d'un formulaire envoyé au serveur, l'attribut name est obligatoire pour que la valeur de cet élément soit transmise avec le formulaire. Dans le cas des formulaires qui figurent dans un document pour tirer parti des possibilités conjointes des éléments de formulaire et des scripts, il n'est pas obligatoire de donner un nom aux éléments textarea, mais il est cependant recommandé de le faire pour pouvoir créer dans le script des références à ces objets, leurs propriétés et leurs méthodes. Les DOM les plus récents recommandent d'affecter le même identifiant à l'attribut id afin de garantir des références de script uniformes pour l'objet élément. |
|
Exemple | |
<TEXTAREA name="comments" id="comments"></TEXTAREA> |
|
Valeur | |
Identifiant sensible à la casse. |
|
Par défaut | |
Aucune. |
|
Référence de modèle d'objet | |
[window.]document.formName.elementName.name [window.]document.forms[i].elements[j].name [window.]document.getElementById(elementID).name |
readonly | NN 6 IE 3 HTML 4 |
readonly | Facultatif |
Lorsque son attribut readonly est présent, l'élément textarea de type champ texte ne peut pas être modifié par le visiteur (mais son contenu peut être modifié à l'aide d'un script). Un élément textarea doté de l'attribut readonly ne doit normalement pas être activé lorsque l'utilisateur appuie sur la touche de tabulation, mais IE 4 pour Macintosh active ce champ quelle que soit la valeur de cet attribut. Les utilisateurs peuvent toujours sélectionner et copier du texte à partir d'un textarea en lecture seule. |
|
Exemple | |
<TEXTAREA name="instructions" readonly></TEXTAREA> |
|
Valeur | |
La présence de cet attribut définit sa valeur comme true (vrai). |
|
Par défaut | |
false |
|
Référence de modèle d'objet | |
[window.]document.formName.elementName.readOnly [window.]document.forms[i].elements[j].readOnly [window.]document.getElementById(elementID).readOnly |
rows | NN tous IE tous HTML tous |
rows="rowCount" | Facultatif |
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. Si le navigateur prend en charge les tailles de police des feuilles de style, la largeur réelle change en conséquence. |
|
Exemple | |
<TEXTAREA rows="5" cols="40"></TEXTAREA> |
|
Valeur | |
Tout entier positif. |
|
Par défaut | |
Varie selon le navigateur et le système d'exploitation. |
|
Référence de modèle d'objet | |
[window.]document.formName.elementName.rows [window.]document.forms[i].elements[j].rows [window.]document.getElementById(elementID).rows |
style | NN 4 IE 4 HTML 4 |
style="styleSheetProperties" | Facultatif |
Cet attribut permet de définir une ou plusieurs propriétés de style pour l'élément considéré. Vous pouvez utiliser la syntaxe CSS ou (pour Navigator 4 uniquement) JavaScript pour affecter des attributs de style. Utilisez l'attribut style uniquement avec les éléments visibles (affichables). |
|
Exemple | |
<span style="color:green; font-size:18px">Big, green, and bold</span> |
|
Valeur | |
L'ensemble de la règle de feuille de style, qui est conforme à la syntaxe des CSS, est entre guillemets. Les divers attributs de style et leurs valeurs sont séparés par des points-virgules. Les attributs des feuilles de style sont présentés en détail dans le chapitre 11. |
|
Par défaut | |
Aucune. |
|
Référence de modèle d'objet | |
[window.]document.getElementById(elementID).style
|
tabindex | NN 6 IE 4 HTML 4 |
tabindex="integer" | Facultatif |
Nombre indiquant la position de cet élément dans l'ordre de tabulation de la page. L'ordre de tabulation suit un ensemble de règles très strictes. Les premiers éléments de la page activés par la touche de tabulation sont ceux dont l'attribut tabindex a une valeur autre que zéro. 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 d'abord dans le document qui est activé le premier. Ensuite viennent les éléments qui ne prennent pas en charge l'attribut tabindex ou ceux pour lesquels la valeur de cet attribut est zéro. Ces éléments sont activés dans l'ordre où ils apparaissent dans le document. Remarque: Si la page actuelle est rechargée, la séquence de tabulation ne recommence pas nécessairement au début. Ainsi, le contrôle de la séquence de tabulation est particulièrement utile lorsque la logique de vos éléments activables ne repose pas sur l'ordre du code source de ces éléments (par exemple, la tabulation se fait en descendant les colonnes des tableaux et non en suivant les lignes). HTML 4 et Netscape 6 limitent l'attribut tabindex aux é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 complètement 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 l'attribut tabindex est donc ignoré dans cette version. |
|
Exemple | |
<a href="chapter3.html" tabindex="3">Chapter 3</a> |
|
Valeur | |
Un entier compris entre 0 et 32767. Dans IE, si l'attribut tabindex reçoit une valeur négative, cet élément ne sera pas inclus dans la séquence de tabulation. |
|
Par défaut | |
Aucune. |
|
Référence de modèle d'objet | |
[window.]document.getElementById(elementID).tabIndex
|
wrap | NN 2 IE 4 HTML s.o. |
wrap="wrapType" | obligatoire |
L'attribut wrap indique au navigateur s'il doit renvoyer le texte à la ligne suivante dans un élément textarea et, dans l'affirmative, s'il doit convertir les renvois à la ligne automatiques en sauts de ligne « en dur » lors de la transmission au serveur. Les spécifications HTML sont muettes à ce sujet, alors que Navigator et Internet Explorer ont, au fil des ans, obscurci les valeurs des attributs. Depuis peu, les navigateurs récents se rejoignent sur un jeu de trois valeurs d'attributs: off, soft et hard. Si vous choisissez la valeur soft, le texte passe automatiquement à la ligne à mesure que l'utilisateur effectue la saisie, mais les retours chariot et les sauts de ligne (CRLF) ne sont pas envoyés avec le formulaire. Si vous choisissez la valeur hard, le retour à la ligne intervient et les sauts de ligne (CRLF) qu'il entraîne sont inclus dans la valeur de textarea transmise au serveur. D'anciens synonymes pour la valeur soft incluent virtual et physical. Si vous choisissez la valeur off, toute saisie effectuée au-delà du bord droit du rectangle impose le défilement horizontal de textarea. Pour passer le pointeur d'insertion du texte à la ligne suivante, vous devez appuyer sur la touche Retour. |
|
Exemple | |
<TEXTAREA name="comments" wrap="hard"></TEXTAREA> |
|
Valeur | |
Constantes: hard | off | soft. |
|
Par défaut | |
soft |
|
Référence de modèle d'objet | |
[window.]document.formName.elementName.wrap [window.]document.forms[i].elements[j].wrap [window.]document.getElementById(elementID).wrap |