<INPUT>NN tous IE tous HTML tous  

<INPUT>

Balise de fin HTML : interdite  

Les éléments input sont parfois appelés contrôles de formulaire, bien que les divers types d'éléments input ne soient pas tous visibles sur la page. Un élément input est essentiellement destiné à offrir un emplacement permettant à l'utilisateur de saisir du texte, de cliquer sur des boutons ou d'effectuer une sélection au sein d'une liste d'options. Les données collectées à partir de ces actions interactives sont transmises à un programme sur le serveur (lorsque l'élément père form est envoyé), ou peuvent être strictement utilisées sur le client, pour autoriser une interactivité entre l'utilisateur et des scripts sur le client. Les applications serveur intègrent souvent des données de session dans les éléments input cachés d'une page, si bien que les données sont envoyées avec le formulaire suivant. Cette méthode permet de répercuter la collecte des données sur plusieurs pages de formulaire sans devoir conserver provisoirement ces données sur le serveur entre les livraisons de page.

Avant la version 4 du langage HTML, les éléments input étaient supposés être inclus dans un élément form dans tous les cas de figure. Cette restriction a été assouplie, mais Navigator 4 nécessite toujours que les éléments input soient inclus dans un élément form pour fonctionner.

Le principal attribut qui est chargé de déterminer le type de contrôle affiché sur la page est l'attribut type. Cet attribut accepte l'une des valeurs suivantes: button, checkbox, file, hidden, image, password, radio, reset, submit ou text. Les divers types d'éléments input n'acceptent pas tous la totalité des attributs définis pour l'élément input; de plus, un attribut donné aura différents rôles selon le type d'élément input avec lequel il est utilisé. La liste précise les types auxquels s'applique chaque attribut de l'élément input. Bien que l'élément textarea possède sa propre balise, il est fréquemment traité comme un contrôle de formulaire.

 
Exemple
 
<FORM method="POST" action="http://www.giantco.com/cgi-bin/query.pl">
First Name: <INPUT type="text" name="first" id="first" maxlength="15"><BR>
Last Name: <INPUT type="text" name="last" id="last" maxlength="25"><BR>
ZIP Code: <INPUT type="text" name="zip" id="zip" maxlength="10"><BR>
<INPUT type="reset">
<INPUT type="submit">
</FORM>
 
Référence de modèle d'objet
 
[window.]document.formName.inputName
[window.]document.forms[i].elements[j]
[window.]document.getElementById(elementID)
 
Attributs spécifiques à l'élément
 
acceptaccesskeyalignaltborder
checkeddataflddatasrcdisableddynsrc
heighthspaceismaplooplowsrc
maxlengthnamereadonlysizesrc
starttypeusemapvaluevspace
width
 
Attributs du gestionnaire d´événements spécifiques à l´élément

Les événements ne sont pas toujours actifs pour tous les types de données input.

GestionnaireNNIEHTML
onafterupdates.o4s.o
onbeforeupdates.o4s.o
onchange234
onselect234
acceptNN 6 IE 6 HTML 4  

accept="MIMETypeList"

Facultatif  

Permet d'indiquer un ou plusieurs types MIME pour les fichiers qui peuvent être transmis au serveur lorsque le formulaire est envoyé. Cet attribut de HTML 4 est utile lorsqu'un navigateur souhaite incorporer un certain niveau de filtrage de type de fichier avant d'envoyer un formulaire incluant l'élément input d'un fichier. A partir de la version 6 des navigateurs, cet attribut n'a, sur le plan pratique, aucune incidence pour la sélection ou l'envoi de fichiers.

 
Exemple
 
<INPUT type="file" accept="text/html, image/gif" ...>
 
Valeur

Constante de type MIME (type de contenu). Il est possible d'indiquer plusieurs valeurs, qui sont alors séparées par des virgules.

 
Par défaut

Aucune.

accesskeyNN 6 IE 3 HTML 4  

accesskey="character"

Facultatif  

Pour des informations générales, reportez-vous à la description de cet attribut partagé au début de ce chapitre. Pour les types input de fichiers, appuyez sur la combinaison accesskey pour placer le pointeur de texte dans la zone de texte associée (cette opération ne permet pas de  «  cliquer   » sur le bouton du navigateur).

alignNN tous IE tous HTML 3.2  

align="alignmentConstant"

Facultatif  

Détermine le type d'alignement du rectangle de l'élément dans le contexte du contenu environnant. Reportez-vous à la section 8.1.5, au début de ce chapitre, pour la description des possibilités définies pour cet attribut avec les éléments img.

 
Exemple
 
<INPUT type="image" name="icon" src="icon.gif" align="absmiddle">
 
Valeur

Constante d'alignement appliquée aux éléments en dehors du rectangle de l'image.

 
Par défaut

left

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.align
[window.]document.forms[i].elements[j].align
[window.]document.getElementById(elementID).align
altNN 6 IE 3 HTML 4  

alt="textMessage"

Facultatif  

Propose une description textuelle de l'image de l'élément input pendant que l'image est en cours de téléchargement, à la place des images affichées ou pour les navigateurs dotés de la synthèse vocale. Adopte le même comportement que l'élément img de l'attribut alt.

 
Exemple
 
<INPUT type="image" name="icon" src="sndIcon.gif" alt="Sound Icon">
 
Valeur

Chaîne de caractères quelconque entre guillemets.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.alt
[window.]document.forms[i].elements[j].alt
[window.]document.getElementById(elementID).alt
borderNN 4 IE 4(Mac) HTML s.o.  

border="pixels"

Facultatif  

Navigator 4 et versions ultérieures sur toutes les plate-formes de système d'exploitation et IE 4 et versions ultérieures sur Macintosh vous permettent de spécifier une bordure autour de l'image de l'élément input. Comme un élément input dont l'attribut type est "image" fonctionne comme un bouton du style Envoyer, la bordure possède la couleur définie pour les liens dans le navigateur, sauf s'il est remplacé par une feuille de style. Pour créer une bordure dans une autre couleur, utilisez les feuilles de style (en imbriquant l'élément img dans l'élément div ou span approprié pour Navigator 4). Navigator 4 (uniquement) place par défaut une bordure autour de l'image. Pour supprimer la bordure, attribuez la valeur zéro à l'attribut border.

 
Exemple
 
<INPUT type="image" name="icon" src="sndIcon.gif" border="0">
 
Valeur

Un nombre entier de pixels.

 
Par défaut

2 (Navigator 4) ou 0 (tous les autres).

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.border
[window.]document.forms[i].elements[j].border
[window.]document.getElementById(elementID).border
checkedNN tous IE tous HTML 4  

checked

Facultatif  

Attribut booléen indiquant si l'élément input de type case à cocher ou bouton radio doit être déjà activé lors du chargement de la page. Dans le cas d'un groupe de boutons radio, un seul de ces éléments input doit avoir l'attribut checked activé. Il est possible de modifier par script la valeur de cet attribut après le chargement de la page. Lorsque le formulaire est envoyé, la paire nom  /  valeur correspondant à l'élément input dont l'attribut checked est activé est envoyée parmi les données du formulaire. La paire nom  /  valeur est composée des valeurs des attributs name et value de cet élément. Si aucune valeur n'est affectée à l'attribut value, la valeur de chaîne "active" ou "on" lui est automatiquement affectée lorsque cette case à cocher ou ce bouton radio sont sélectionnés. Cette méthode est efficace pour les cases à cocher, puisque chacune doit posséder un nom unique. Par contre, tous les boutons radio d'un même groupe doivent avoir le même nom, afin que les navigateurs puisse gérer l'activation et la désactivation au sein du groupe. Ce comportement par défaut ne fournit pas suffisamment d'informations pour que la plupart des programmes sur le serveur puissent les utiliser. Reportez-vous à l'attribut name ci-dessous.

 
Exemple
 
<INPUT type="checkbox" name="addToList" checked>Send email updates to this
web site.
 
Valeur

La présence de cet attribut active sa propriété.

 
Par défaut

Off.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.checked
[window.]document.forms[i].elements[j].checked
[window.]document.getElementById(elementID).checked
datafldNN n/a IE 4 HTML |4|  

datafld="nom_colonne"

Facultatif  

Cet attribut est utilisé avec IE dans le cadre d'une liaison de données, pour associer le nom d'une colonne d'une source de données distante à divers éléments input. 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.

Cet attribut a été réservé dans HTML 4, mais il a été abandonné dans XHTML 1.0.

 
Exemple
 
<INPUT type="text" name="first" datasrc="DBSRC3" datafld="firstName">
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.dataFld
[window.]document.forms[i].elements[j].dataFld
[window.]document.getElementById(elementID).dataFld
datasrcNN n/a IE 4 HTML |4|  

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 pour Mac.

Cet attribut a été réservé dans HTML 4, mais il a été abandonné dans XHTML 1.0.

 
Exemple
 
<INPUT type="text" name="first" datasrc="DBSRC3" datafld="firstName">
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.dataSrc
[window.]document.forms[i].elements[j].dataSrc
[window.]document.getElementById(elementID).dataSrc
disabledNN 6 IE 3 HTML 4  

disabled

Facultatif  

Un élément input désactivé est affiché en grisé et ne peut pas être activé par l'utilisateur. Un contrôle de formulaire désactivé ne peut pas être l'élément actif et il ne figure donc pas dans la séquence d'activation par appui sur la touche de tabulation. IE pour Windows élargit cette caractéristique comme suit: si un bouton radio d'un groupe est désactivé, le groupe entier est désactivé. Tel n'est pas le cas dans IE pour Mac ou Netscape 6; en effet, un bouton qui n'est pas en surbrillance peut désélectionner un membre sélectionné, mais désactivé du groupe.

La paire nom  /valeur d'un élément input désactivé n'est pas transmise au serveur en même temps que le formulaire. Les éléments input qui effectuent normalement les transmissions n'envoient pas leurs formulaires s'ils sont désactivés.

L'attribut disabled est de type booléen, ce qui signifie que, dans le format HTML, sa simple présence dans les ensembles d'attributs définit sa valeur sur true. Cette valeur peut également être modifiée par la suite à l'aide d'un script (voir l'objet button dans le chapitre  9).

 
Exemple
 
<BUTTON type="submit" disabled>Ready to Submit </BUTTON>
 
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.inputName.disabled
[window.]document.forms[i].elements[j].disabled
[window.]document.getElementById(elementID).disabled
dynsrcNN s.o. IE 4 HTML s.o.  

dynsrc="URL"

Facultatif  

Internet Explorer 4 et les versions ultérieures permettent d'afficher des clips vidéo (et des fichiers VRML) à l'aide d'un élément input de type image. Pour aider le navigateur à différencier les sources d'images statiques ou dynamiques, vous pouvez utiliser l'attribut dynsrc à la place de l'attribut src pour charger le clip vidéo. Tous les autres aspects visuels de l'élément input sont donc immédiatement applicables à la zone rectangulaire destinée à l'affichage du clip vidéo. Consultez les sections consacrées aux attributs loop, qui permet de contrôler le nombre de lectures du clip, et start.

 
Exemple
 
<INPUT type="image" dynsrc="submit.avi" alt="Submit Button" loop="3" height="100" width="150">
 
Valeur

Toute adresse URL valide (complète ou relative).

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.dynsrc
[window.]document.forms[i].elements[j].dynsrc
[window.]document.getElementById(elementID).dynsrc
height, widthNN 4 IE 4 HTML s.o.  

height="pixels" width="pixels"

Facultatif  

Définit les dimensions de l'image utilisées pour l'élément input. Si vous omettez ces attributs, le navigateur attend que l'image soit chargée avant d'allouer de l'espace pour l'élément sur la page.

 
Exemple
 
<INPUT type="image" src="submit.jpg" height="20" width="60">
 
Valeur

Entiers positifs.

 
Par défaut

Taille d'image par défaut.

hspace, vspaceNN 6 IE 4 HTML s.o.  

height="pixels" width="pixels"

Facultatif  

Définit un remplissage supplémentaire autour de l'image (donc, de l'élément input) afin de conserver l'autre contenu à une distance minimale. L'élément hspace contrôle l'épaisseur du remplissage pour les côtés gauche et droit; vspace fait de même pour les côtés supérieur et inférieur.

 
Exemple
 
<INPUT type="image" src="submit.jpg" alt="Submit Button"
height="20" width="60" hspace="10" vspace="20">
 
Valeur

Entiers positifs.

 
Par défaut

0

idNN 4 IE 4 HTML 4

id="elementIdentifier"

Facultatif

Identifiant unique qui distingue cet élément de tous les autres au sein du document. Peut être utilisé pour associer un simple élément à une règle de style nommant cette valeur d'attribut — en tant que sélecteur d'ID. Un élément peut recevoir un ID qui en assurera l'unicité, ainsi qu'une classe qui le rattachera à un groupe. Reportez-vous au chapitre 3.

IE 4 et les versions ultérieures ainsi que Netscape 6 autorisent les attributs id pour les éléments non affichables, mais si votre code requiert une validation, sachez que les DTD HTML 4 W3C et XHTML ne l'autorisent pas. Comme tous les éléments du DOM W3C ont une propriété id, il est naturel d'affecter un attribut id aux éléments non affichables si les scripts doivent référencer ces éléments. Ou vos scripts peuvent utiliser d'autres moyens (par exemple le tableau renvoyé par document.getElementsByTagName( )) pour référencer de tels éléments.

Affectez des identifiants aux attributs id afin de dupliquer des valeurs précédemment affectées seulement aux attributs name dans des éléments comprenant l'attribut name. Les contrôles de formulaire des navigateurs actuels nécessitent encore des attributs name pour que les paires nom/valeur soient envoyées avec le formulaire et les éléments a jouant le rôle d'ancres nécessitent toujours ces attributs de nom. N'oubliez pas d'affecter un identifiant à l'attribut id de tout élément que vous avez l'intention de référencer par script.

 
Exemple
 
<h2 id="sect3Head">Section Three</h2>
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).id
ismapNN tous IE tous HTML tous  

ismap

Facultatif  

L'attribut booléen ismap indique au navigateur que l'image représentant l'élément input est une carte image (image interactive) côté serveur. Contrairement à l'élément img, une action (la transmission du formulaire) est associée au type d'image input; aucun élément a environnant n'est donc requis. Le navigateur ajoute les informations relatives aux coordonnées du clic à l'adresse URL de l'action du formulaire. Reportez-vous à l'attribut usemap pour plus de détails sur la carte image côté client.

 
Exemple
 
<INPUT type="image src="navbar.gif" alt="Navigation Bar" ismap height="90" width="120">
 
Valeur

La présence de cet attribut active sa fonctionnalité.

 
Par défaut

Off.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.isMap
[window.]document.forms[i].elements[j].isMap
[window.]document.getElementById(elementID).isMap
titleNN 6 IE 3 HTML 3.2

title="advisoryText"

Facultatif

Description de l'élément. Pour les éléments HTML qui produisent du contenu visible sur la page, IE 4 et versions ultérieures ainsi que Netscape 6 affichent le contenu de l'attribut title sous forme d'info-bulle lorsque le curseur reste un moment sur l'élément concerné. Par exemple, l'élément de colonne col n'affiche pas le contenu, donc son attribut title fournit simplement des informations. Pour générer des info-bulles dans les tableaux, affectez des attributs title aux éléments tels que table, tr, th ou td.

Les propriétés de police et de couleur sont régies par le navigateur et ne peuvent pas être modifiées par script. Dans IE pour Windows, l'info-bulle est le petit rectangle jaune clair standard; dans IE pour Macintosh, l'info-bulle s'affiche comme une bulle de BD, à la manière du système d'aide de MacOS. Dans Netscape 6, les info-bulles s'affichent toujours sous la forme du même petit rectangle quelle que soit la version du système d'exploitation. Si aucun attribut n'est spécifié, l'info-bulle ne s'affiche pas.

Vous pouvez affecter à cet attribut le texte descriptif de votre choix. Etant donné que tout le monde ne le verra pas, n'y placez pas d'informations essentielles. Peut-être les navigateurs conçus pour satisfaire les critères d'accessibilité Web utiliseront-ils les informations de cet attribut pour lire les informations au sujet d'un lien ou d'éléments autres que du texte à des utilisateurs malvoyants. Donc, ne négligez pas cette aide potentiellement utile pour décrire l'objectif d'un élément sur une page.

Bien que les indications de compatibilité pour cet attribut le fassent remonter à l'époque de Microsoft Internet Explorer 3 et HTML 3.2, il est nouvellement affecté à de nombreux éléments à partir de Microsoft Internet Explorer 4 et de HTML 4.0.

 
Exemple
 
<span title="United States of America">U.S.A.</span>
 
Valeur

Toute chaîne de caractères. Cette chaîne doit figurer entre guillemets (simples ou doubles, mais identiques).

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).title
loopNN s.o. IE 3 HTML s.o.  

loop="loopCount"

Facultatif  

Si vous avez spécifié un clip vidéo à l'aide de l'attribut dynsrc, l'attribut loop permet de contrôler le nombre de lectures ("en boucle") du clip après son chargement. Si vous donnez la valeur zéro à cet attribut, le clip est chargé mais sa lecture n'est pas immédiatement déclenchée. La lecture des clips vidéo qui ne sont pas déjà en cours d'exécution est déclenchée lorsque l'utilisateur double-clique sur l'image, mais il peut être nécessaire de fournir à l'utilisateur des instructions à cet effet, car aucun contrôle n'est visible.

 
Exemple
 
<INPUT type="image" dynsrc="snowman.avi" alt="Snowman Movie" loop="3"
height="100" width="150">
 
Valeur

Tout entier positif, ou zéro.

 
Par défaut

1

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.loop
[window.]document.forms[i].elements[j].loop
[window.]document.getElementById(elementID).loop
lowsrcNN tous IE 4 HTML s.o.  

lowsrc="URL"

Facultatif  

Fournit l'URL d'une autre image basse résolution qui sera chargée au démarrage, si le chargement de l'image src est trop long.

 
Exemple
 
<INPUT type="image" src="navbar.jpg" alt="Navigation Bar" lowsrc="navbarBW.jpg"
height="60" width="300">
 
Valeur

Toute adresse URL valide (complète ou relative).

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.lowsrc
[window.]document.forms[i].elements[j].lowsrc
[window.]document.getElementById(elementID).lowsrc
maxlengthNN tous IE tous HTML tous  

maxlength="characterCount"

Facultatif  

Définit le nombre maximal de caractères qui peuvent être saisis dans un élément input de type champ texte. En pratique, les navigateurs préviennent l'utilisateur (par un signal sonore ou un message) lorsque le nombre de caractères saisis dépasse la valeur paramétrée pour maxlength. Il n'existe pas de corrélation directe entre les attributs maxlength et size. Si maxLength autorise un nombre de caractères supérieur à ce que la largeur de l'élément permet d'afficher, le navigateur assure un défilement horizontal (très peu apprécié de la plupart des utilisateurs) pour autoriser la saisie et la modification du contenu de ce champ.

 
Exemple
 
<INPUT type="text" name="ZIP" maxlength="10">
 
Valeur

Entier positif.

 
Par défaut

Illimitée.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.maxLength
[window.]document.forms[i].elements[j].maxLength
[window.]document.getElementById(elementID).maxLength
nameNN tous IE tous HTML tous  

name="elementIdentifier"

Facultatif  /  Obligatoire  

Si l'élément input 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 input, 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.

L'identifiant que vous affectez à l'attribut name devient partie intégrante de la paire nom  /  valeur transmise au serveur. Les éléments de bouton radio qui doivent avoir une fonction de groupe mutuellement exclusif doivent tous posséder la même valeur d'attribut name. Dans la plupart des navigateurs, s'il est impossible d'inclure une affectation d'attribut name, les utilisateurs ne peuvent pas accéder aux éléments input des cases à cocher ou des boutons radio.

Les spécifications HTML 4 et XHTML recommandet le remplacement de l'attribut id par l'attribut name dans vos pages. Les navigateurs standard, jusqu'à la version 6, ne transmettent pas les données des éléments input qui incluent une affectation id, mais aucune affectation name. Par souci de cohérence avec l'accès DOM, sur la base de scripts DHTML, à tous les éléments, il est recommandé d'affecter les deux attributs, voire d'employer le même identifiant pour les deux (sauf dans le cas des boutons radio, qui doivent avoir un ID unique, alors que leurs noms peuvent être partagés). L'attribut name achemine la valeur de l'élément vers le serveur, tandis que les scripts atteignent les éléments par l'intermédiaire de leurs ID, notamment dans les navigateurs qui utilisent la syntaxe de référence document.all.elementID (IE) ou document.getElementById(elementID) (DOM W3C). La DTD XHTML stricte valide, peut-être de manière forcée, l'attribut name pour les éléments input de sorte que les pages validées fonctionnent dans le cadre de l'implémentation des navigateurs actuels et précédents.

 
Exemple
 
<INPUT type="text" name="ZIP" id="ZIP" maxlength="10">
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.name
[window.]document.forms[i].elements[j].name
[window.]document.getElementById(elementID).name
readonlyNN 6 IE 3 HTML 4  

readonly

Facultatif  

Lorsque son attribut readonly est présent, un élément input de type champ texte ne peut pas être modifié par le visiteur (mais son contenu peut être modifié à l'aide d'un script). Un champ doté de l'attribut readonly ne doit normalement pas être activé lorsque l'utilisateur appuie sur la touche de tabulation, mais IE 4 et les versions ultérieures pour Macintosh activent ce champ, quelle que soit la valeur de cet attribut, et émettent un signal sonore si l'utilisateur essaie de taper.

 
Exemple
 
<INPUT type="text" name="ZIP" readonly>
 
Valeur

La présence de cet attribut définit sa valeur sur true (vrai).

 
Par défaut

false

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.readOnly
[window.]document.forms[i].elements[j].readOnly
[window.]document.getElementById(elementID).readOnly
sizeNN tous IE tous HTML tous  

size="elementWidth"

Facultatif  

Dans la pratique, l'attribut size se limite à la description de la largeur (en nombre de caractères) des éléments input de type champ de texte. La largeur effective est calculée à partir de la police définie pour l'élément, ou de la police par défaut, mais le résultat est loin d'être toujours parfait. Certaines variantes de rendu des polices (et, dans les navigateurs les plus récents, la possibilité de choisir des polices et des tailles différentes) entraînent parfois l'affichage de champs trop étroits. Il est donc déconseillé d'attribuer automatiquement la même valeur aux attributs size et maxlength sans tester le résultat sur un grand nombre de navigateurs et de systèmes d'exploitation, et en prévoyant le pire (par exemple, en tapant une série de caractères "m" ou "W" en police proportionnelle). Selon les spécifications HTML 4, l'attribut size peut être appliqué à d'autres types de l'élément input (sous forme de pixels, plus que de caractères), mais ce n'est pas le cas avec la version 6 des navigateurs. Vous pouvez toutefois utiliser les attributs CSS pour obtenir des boutons plus larges que leur largeur par défaut, qui est basée sur la largeur définie par l'attribut value.

 
Exemple
 
<INPUT type="text" name="ZIP" maxlength="10" size="12">
 
Valeur

Tout entier positif.

 
Par défaut

20

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.size
[window.]document.forms[i].elements[j].size
[window.]document.getElementById(elementID).size
srcNN tous IE tous HTML tous  

src="URL"

obligatoire  

Adresse URL d'un fichier contenant l'image affichée par le type «  image  » de l'élément input. Le navigateur doit prendre en charge le type MIME du format d'image utilisé. Sur le World Wide Web, les formats d'image les plus répandus sont GIF et JPEG.

 
Exemple
 
<INPUT type="image" name="icon" src="sndIcon.gif" border="0">
 
Valeur

Une adresse URL complète ou relative.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.src
[window.]document.forms[i].elements[j].src
[window.]document.getElementById(elementID).src
startNN s.o. IE 4 HTML s.o.  

start="videoStartType"

Facultatif  

Si vous utilisez l'attribut dynsrc d'un élément input de type image pour afficher un clip vidéo dans Internet Explorer, vous pouvez indiquer à cet élément que la lecture du clip doit débuter automatiquement dès la fin du chargement du fichier vidéo, ou seulement lorsque l'utilisateur amène le curseur sur cette image. L'attribut start permet de choisir l'interface utilisateur de votre page.

 
Exemple
 
<INPUT type="image dynsrc="submit.avi" alt="Submit Button" loop="1"
start="mouseover" height="100" width="150">
 
Valeur

Une des deux constantes suivantes, non sensibles à la casse: fileopen | mouseover.

 
Par défaut

fileopen

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.start
[window.]document.forms[i].elements[j].start
[window.]document.getElementById(elementID).start
tabindexNN 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
typeNN tous IE tous HTML tous  

type="elementType"

obligatoire  

Indique au navigateur le type d'élément input, donc la façon dont il doit être affiché (ou signifie éventuellement que cet élément ne doit pas être affiché). Les choix possibles sont les suivants.

TypeDescription
buttonBouton sur lequel l'utilisateur peut cliquer, et dont l'action doit être contrôlée par script. L'étiquette de ce bouton est affectée par l'attribut value. Si vous désirez utiliser du code HTML pour modifier le formatage de ce contenu, utilisez l'élément button, au lieu de l'élément input de type  «  button   ».
checkboxCase à cocher isolée possédant deux états (activée/on et désactivée/off). Son texte explicatif figure dans un texte HTML qui précède ou suit la balise de l'élément input (reportez-vous aussi à l'élément label). La valeur de l'attribut value est transmise avec le formulaire.
fileBouton accompagné d'un texte, qui permet à l'utilisateur de sélectionner un fichier local pour le transmettre au serveur. Un clic sur ce bouton fait apparaître la boîte de dialogue "Fichier", et le nom (ou le chemin) du fichier sélectionné apparaît dans le champ d'accompagnement du bouton. Un script CGI doit être exécuté sur le serveur (appelé l'URI de l'attribut action du formulaire) pour accepter en temps réel le fichier transmis par l'utilisateur.
hiddenChamp invisible fréquemment utilisé pour conserver les données d'une base de données ou les données d'état entre deux soumissions, sans que l'utilisateur ait à se préoccuper de son contenu (ou sans avoir à stocker provisoirement ces données sur le serveur). La paire nom  /  valeur est transmise avec le formulaire.
imageBouton graphique dont la seule action par défaut possible consiste à transmettre le formulaire. Les coordonnées x et y du point cliqué dans l'image sont transmises sous forme de deux paires nom  /  valeur reliées par une esperluette: inputName.x=n&inputName.y=m.
passwordChamp texte affichant des symboles graphiques ou des astérisques lors de la frappe des caractères, pour que personne ne puisse lire le code indiqué par-dessus l'épaule de l'utilisateur. Le texte tapé (en clair) est envoyé comme valeur de cet élément.
radioChaque bouton d'un groupe de boutons dits "boutons radio" (l'activation de l'un d'entre eux désactive tous les autres, comme les boutons de présélection des anciens postes de radio). Pour grouper plusieurs boutons radio de sorte que l'activation de l'un désactive tous les autres, il faut donner la même valeur à leur attribut name. Un clic sur l'un des boutons de ce groupe désactive alors tous les autres. La valeur de l'attribut value du membre activé est transmise avec le formulaire.
resetBouton dont le seul rôle consiste à réinitialiser tous les éléments du formulaire à leurs valeurs initiales, lors du chargement du formulaire par le navigateur client. Le contenu de ce bouton (texte explicatif) peut être défini à l'aide de l'attribut value.
submitBouton dont la seule fonction consiste à transmettre ("soumettre") le formulaire. Le contenu de ce bouton (texte explicatif) peut être défini par l'attribut value. Si les attributs name et value de cet élément ont reçu des valeurs, celles-ci sont transmises avec le formulaire.
textChamp texte d'une seule ligne, permettant à l'utilisateur de saisir du texte qui sera transmis comme valeur de cet élément (dans un format codé sous forme d'adresse URL). Pour obtenir un champ texte de plusieurs lignes, utilisez l'élément textarea.
 
Exemple
 
<INPUT type="button" value="Toggle Sound" onclick="toggleSnd( )">
<INPUT type="checkbox" name="connections" value="ISDN">ISDN
<INPUT type="file" name="uploadFile">
<INPUT type="hidden" name="prevState" id="prevState" value="modify">
<INPUT type="image" name="graphicSubmit" src="submit.jpg" height="40" width="40">
<INPUT type="password" name="password" maxlength="12" size="20">
<INPUT type="radio" name="creditCard" value="Visa">Visa
<INPUT type="reset">
<INPUT type="submit" value="Send Encrypted">
Social Security Number:<INPUT type="text" name="ssn" value="###-##-####"
onclick="validateSSN(this)">
 
Valeur

L'un des types possibles de l'élément input: button | checkbox | file | hidden | image | password | radio | reset | submit | text.

 
Par défaut

text

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.type
[window.]document.forms[i].elements[j].type
[window.]document.getElementById(elementID).type
usemapNN 6 IE 6 HTML 4  

usemap="mapURL"

Facultatif  

Vous pouvez définir une carte image côté client pour un élément input de type image à l'aide des éléments map et area. L'élément map est le conteneur nommé d'un ou plusieurs éléments area. Chaque élément area définit une zone sensible de l'image et affecte une destination (et autres paramètres) à un lien en réponse au clic de l'utilisateur dans cette zone. La raison d'être de l'élément usemap consiste à établir une connexion entre l'élément input de type image et un élément map nommé figurant dans le même document. Dans un sens, le nom de l'élément map est traité comme une ancre, dans la mesure où son "adresse" est le nom de l'élément précédé du symbole #.

 
Exemple
 
<INPUT type="image" src="submit.gif" alt="Submit Button" usemap="#submitter"
height="90" width="120">
 
Valeur

Adresse URL pointant sur l'élément map dans le même document (symbole dièse suivi du nom de l'élément map).

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.useMap
[window.]document.forms[i].elements[j].useMap
[window.]document.getElementById(elementID).useMap
valueNN tous IE tous HTML tous  

value="text"

Facultatif  /  Obligatoire  

Affecte une valeur préalable à l'élément input, qui est transmise au serveur dans le cadre de la paire nom  /  valeur de cet élément. Certains types de l'élément input ne sont pas envoyés (par exemple les boutons radio non activés), mais toute valeur associée à un élément input, sauf à ceux qui sont de type "button" ou "reset", est envoyée au serveur avec l'élément.

Dans le cas des éléments input de type  «  text   » et  «  password   », l'attribut value contient une valeur par défaut. Lorsque l'utilisateur modifie le contenu du champ texte, la valeur de celui-ci change, mais pas le code source. Lorsqu'un formulaire est réinitialisé (à l'aide d'un élément input de type  «  reset   »), Les valeurs par défaut sont replacées dans les champs texte.

L'attribut value n'est obligatoire que pour les éléments input de type  «  checkbox   » et  «  radio   ». Pour les éléments input qui apparaissent sous la forme de boutons standard pouvant être cliqués, l'attribut value définit le texte du bouton.

 
Exemple
 
<INPUT type="checkbox" name="connections" value="ISDN">ISDN
 
Valeur

Toute chaîne de texte.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.formName.inputName.defaultValue
[window.]document.forms[i].elements[j].defaultValue
[window.]document.getElementById(elementID).defaultValue
[window.]document.formName.inputName.value
[window.]document.forms[i].elements[j].value
[window.]document.getElementById(elementID).value  
vspace  

  

Voir hspace.

width  

  

Voir height.