<input>
L'élément HTML <input>
est utilisé pour créer un contrôle interactif dans un formulaire web qui permet à l'utilisateur de saisir des données. Les saisies possibles et le comportement de l'élément <input>
dépend fortement de la valeur indiquée dans son attribut type
.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Les différents types de champs <input>
La façon dont un élément <input>
fonctionne dépend grandement de la valeur de son attribut type
. Aussi, pour chacun de ces types, on aura une page de référence dédiée. Par défaut, lorsque l'attribut type
n'est pas présent, il aura la valeur implicite text
.
Les types de champs disponibles sont :
button
: un bouton sans comportement défini.checkbox
: une case à cocher qui permet de sélectionner/déselectionner une valeurcolor
: HTML5 un contrôle qui permet de définir une couleur.date
: HTML5 un contrôle qui permet de saisir une date (composé d'un jour, d'un mois et d'une année).datetime-local
: HTML5 un contrôle qui permet de saisir une date et une heure (sans fuseau horaire).email
: HTML5 un champ qui permet de saisir une adresse éléctronique.file
: un contrôle qui permet de sélectionner un fichier. L'attributaccept
définit les types de fichiers qui peuvent être sélectionnés.hidden
: un contrôle qui n'est pas affiché mais dont la valeur est envoyée au serveur.image
: un bouton graphique d'envoi du formulaire. L'attributsrc
doit être défini avec la source de l'image et l'attributalt
doit être défini avec le texte alternatif. Les attributsheight
etwidth
permettent de définir la taille de l'image en pixels.month
: HTML5 un contrôle qui permet de saisir un mois et une année (sans fuseau horaire).number
: HTML5 un contrôle qui permet de saisir un nombre.password
: un champ texte sur une seule ligne dont la valeur est masquée. Les attributsmaxlength
etminlength
définissent la taille maximale et minimale de la valeur à saisir dans le champ.Note : Tout formulaire comportant des données sensibles doit être servi via HTTPS. Les navigateurs alertent les utilisateurs lorsque les formulaires avec de telles données sont uniquement disponibles via HTTP.radio
: un bouton radio qui permet de sélectionner une seule valeur parmi un groupe de différentes valeurs.range
: HTML5 un contrôle qui permet de saisir un nombre dont la valeur exacte n'est pas importante.reset
: un bouton qui réinitialise le contenu du formulaire avec les valeurs par défaut.search
: HTML5 un champ texte sur une ligne pour des termes de recherche. Les sauts de ligne sont automatiquement retirés.submit
: un bouton qui envoie le formulaire.tel
: HTML5 un contrôle pour saisir un numéro de téléphone.text
: un champ texte sur une seule ligne. Les sauts de ligne sont automatiquement retirés.time
: HTML5 A control for entering a time value with no time zone.url
: HTML5 un champ permettant de saisir une URL.week
: HTML5 un contrôle permettant de saisir une date représentée par un numéro de semaine et une année (sans indication de fuseau horaire).
Certains types sont désormais obsolètes :
datetime
: HTML5 un contrôle pour saisir une date et une heure selon un fuseau horaire UTC. Cette fonctionnalité a été retirée du standard WHATWG HTML.
Attributs
L'élément <input>
est l'un des éléments HTML les plus complexes et puissants et il peut utiliser de nombreux types et attributs. Chaque élément <input>
étant basé sur l'interface DOM HTMLInputElement
, ils partagent tous, techniquement, les mêmes attributs. Toutefois, certains attributs ne fonctionnent que pour certains types de champs et certains attributs fonctionnent spécifiquement selon le type de champ.
Sur cette page, vous trouverez des informations sur les attributs communs à l'ensemble des types d'éléments <input>
ainsi que la description de quelques attributs notables.
Attributs communs à l'ensemble des types
This section lists the attributes which are used by all form <input>
types. Attributes that are unique to particular input types—or attributes which are common to all input types but have special behaviors when used on a given input type—are instead documented on those types' pages.
Note : Les éléments <input>
peuvent bien entendu utiliser les attributs universels.
Attribut | Description |
---|---|
autocomplete |
Une chaîne de caractères qui indique le type d'autocomplétion à utiliser. |
autofocus |
Un attribut booléen qui passe le focus sur le champ lorsque le formulaire est affiché. |
disabled |
Un attribut booléen qui indique si le champ doit être désactivé. |
form |
L'identifiant du formulaire (la valeur de l'attribut id de l'élément <form> ) auquel le champ est rattaché. Si cet attribut est absent, le champ sera rattaché au formulaire le plus proche qui le contient s'il existe. |
list |
L'identifiant (valeur de l'attribut id ) d'un élément <datalist> qui fournit une liste de suggestions. |
name |
Le nom du champ qui sera rattaché à la donnée envoyée via le formulaire. |
readonly |
Un attribut booléen qui indique si le champ peut être édité ou non. |
required |
Un attribut booléen qui indique que le champ doit être renseigné avant de pouvoir envoyer le formulaire. |
tabindex |
Une valeur numérique qui indique à l'agent utilisateur l'ordre selon lequel naviguer au clavier grâce à la touche Tab. |
type |
Une chaîne de caractère qui indique le type de champ représenté par l'élément <input> . |
value |
La valeur du champ. |
autocomplete
Une chaîne de caractères qui décrit si le champ doit fournir des fonctionnalités d'autocomplétion. Cette autocomplétion peut notamment provenir des valeurs précédemment saisies dans le champ. D'autres méthodes plus complexes peuvent être utilisées : un navigateur pourra par exemple interagir avec la liste des contacts de l'appareil afin de proposer l'autocomplétion pour les adresses électroniques. Voir Valeurs in autocomplete pour les valeurs qui peuvent être utilisées avec cet attribut.
Cet attribut n'aura aucun effet sur les champs qui ne renvoient pas de valeurs numériques ou de textes (les champs checkbox
ou image
par exemple).
Pour plus d'informations, voir la page de documentation sur l'attribut HTML autocomplete
.
autofocus
Un attribut booléen qui, lorsqu'il est présent, indique que le champ doit recevoir le focus lorsque le chargement de la page est terminé (ou que la boîte de dialogue (<dialog>
) contenant l'élément est affichée).
Note : Un élément ayant l'attribut autofocus
peut avoir le focus avant que l'évènement DOMContentLoaded
soit déclenché.
Seul un élément du document peut avoir l'attribut autofocus
. Il n'est pas possible d'utiliser l'attribut autofocus
sur les champs de type hidden
car ces derniers, masqués, ne peuvent pas avoir le focus.
Attention ! Le focus automatique sur un champ de formulaire peut être source de confusion, notamment pour les personnes qui utilisent des lecteurs d'écran. En effet, lorsque autofocus
est utilisé, les lecteurs d'écran « téléportent » l'utilisateur sur le contrôle du champ, sans aucun avertissement.
disabled
Un attribut booléen qui, lorsqu'il est présent, indique que l'utilisateur ne devrait pas pouvoir interagir avec le champ. Les champs désactivés sont généralement affichés avec une couleur plus pale et/ou avec d'autres indications.
Les champs désactivés avec cet attribut ne reçoivent pas l'évènement click
et ne sont pas envoyés avec le formulaire.
Note : Bien que ce ne soit pas indiqué dans la spécification, Firefox conserver l'état désactivé des champs, y compris si cet état a été obtenu dynamiquement, lors des rechargements de la page. L'attribut autocomplete
pourra être utilisé afin de contrôler cette fonctionnalité.
form
Une chaîne de caractères qui indique l'élément <form>
auquel le champ est associé (on parle de « formulaire propriétaire »). La valeur de cette chaîne de caractères doit correspondre à la valeur de l'attribut id
d'un élément <form>
du document. Si cet attribut n'est pas utilisé, l'élément <input>
est rattaché au formulaire le plus proche qui le contient (si un tel formulaire existe).
Grâce à cet attribut, on peut placer un champ n'importe où dans le document et avoir un lien entre le champ et un formulaire situé ailleurs.
Note : Un champ ne peut être associé qu'à un seul formulaire.
list
Cet attribut est une chaîne de caractères qui correspond à l'identifiant (id
) d'un élément <datalist>
du document et qui fournit une liste de valeurs à suggérer à l'utilisateur pour ce champ. Les valeurs de cette liste qui ne sont pas compatibles avec ce type de champ ne seront pas incluses dans les suggestions.
L'attribut list
n'est pas pris en charge pour les types hidden
, password
, checkbox
, radio
, file
ou pour les boutons.
name
Une chaîne de caractères qui définit le nom associé au champ. Ce nom sera envoyé avec la valeur lors de l'envoi du formulaire.
Lorsqu'un champ a un nom, cette valeur devient une propriété de HTMLFormElement.elements
qu'on pourra utiliser en JavaScript (ex. si on a un attribut name
qui vaut hat-size
:
let form = document.querySelector("form");
let guestName = form.elements.guest;
let hatSize = form.elements["hat-size"];
Avec ce code, la variable guestName
correspondra à l'élément HTMLInputElement
du champ guest
et hatSize
à l'objet pour le champ hat-size
.
Attention ! Il est préférable de ne pas utiliser de valeurs pour name
qui correspondent à une propriété native de l'objet du DOM car cela surchargerait la propriété préexistante avec une référence au champ concerné.
Le nom _charset_
possède une signification spéciale. Si cette valeur est utilisée comme nom pour un élément <input>
de type hidden
, la valeur du champ (l'attribut value
) sera automatiquememnt renseignée par l'agent utilisateur et correspondra à l'encodage utilisé pour envoyer le formulaire.
Si l'attribut name
n'est pas présent ou qu'il est vide, la valeur du champ ne sera pas envoyée avec le formulaire.
Note : Pour certaines raisons historiques, le nom isindex
n'est pas autorisé. Pour en savoir plus, voir la section Nommage des contrôles de formulaire : l'attribut name
de la spécification HTML.
readonly
Un attribut booléen qui, lorsqu'il est présent, indique que l'utilisateur ne devrait pas pouvoir éditer la valeur du champ.
disabled
et readonly
sont bien différents : readonly
permet d'avoir un contrôle fonctionnel mais non éditable alors que les champs disabled
ne fonctionnent pas comme des contrôles.
Notes :
L'attribut required
n'est pas autorisé sur les éléments <input>
avec l'attribut readonly
.
Seuls les champs textuels peuvent être mis en lecture seule. En effet, pour les autres contrôles (ex. les case à cocher et les boutons radio), il n'y a pas de réelle différence entre l'application de readonly
ou de disabled
.
required
Un attribut booléen qui, lorsqu'il est présent, indique que l'utilisateur doit fournir une valeur pour ce champ avant de pouvoir envoyer le formulaire. L'attribut required
est pris en charge pour tous les types d'éléments <input>
exceptés :
Lorsqu'un champ contient l'attribut, la pseudo-classe CSS :required
lui est appliqué. À l'inverse, les champs qui n'ont pas d'attribut required
auront la pseudo-classe :optional
appliquée (cela ne s'applique pas aux types de champ qui ne prennent pas en charge require
).
Note : Un champ en lecture seule pouvant ne pas avoir de valeur, l'attribut required
n'aura pas d'effet sur les champs ayant également l'attribut readonly
.
tabindex
Une valeur nnumérique qui définit si le champ peut recevoir le focus via la navigation au clavier (en navigant avec la touche Tab) et la façon dont l'élément s'inscrit dans l'ordre de la navigation au clavier.
Les valeurs de tabindex
auront un sens différents selon leur signe :
- Lorsque
tabindex
est une valeur négative, cela indique que l'élément peut recevoir le focus de la part de l'utilisateur mais sans utiliser la navigation séquentielle au clavier. Il est recommandé de toujours utiliser une valeur de-1
dans ce cas. - Lorsque
tabindex
est nul, cela indique que l'élément peut recevoir le focus et peut être accessible via la navigation au clavier mais que l'ordre de navigation est laissé à la discrétion de l'agent utilisateur. C'est généralement la meilleure valeur à utiliser. - Lorsque
tabindex
est une valeur positive, cette dernière définit l'ordre de l'élément dans la navigation au clavier. Chaque fois que l'utilisateur appuie sur la touche Tab, le focus passe à un élément qui possède un attributtabindex
plus élevé. La plupart des plateformes disposent également d'une fonctionnalité pour « reculer » dans la navigation au clavier, généralement via la combinaison de touches Shift + Tab.
Si cet attribut est absent ou n'est pas un entier valide, ce sera à l'agent utilisateur de respecter les conventions de la plateforme sous-jacente pour la navigation au clavier et la gestion du focus.
type
Une chaîne de caractères qui indique le type de contrôle à afficher. On pourra par exemple avoir une case à cocher en utilisant la valeur checkbox
. Lorsque cet attribut est absent ou qu'une valeur inconnue est utilisée, la valeur par défaut sera text
et le contrôle créé permettra de saisir un texte.
Les valeurs autorisées pour cet attribut sont présentées plus haut.
value
La valeur du champ. Lorsque cet attribut est indiqué en HTML, il correspond à la valeur initiale du champ qui peut ensuite être modifié par l'utilisateur. Cette valeur peut également être récupérée et modifiée en JavaScript grâce à la propriété value
de l'objet HTMLInputElement
. Cet attribut est toujours optionnel.
Note : À la différence des autres contrôles, les cases à cocher et les boutons radio sont uniquemnet envoyés via le formulaire lorsque l'attribut checked
est vrai. Dans ce cas, l'attribut value
sera la valeur associée au champ.
Aussi, si on a une case à cocher dont l'attribut name
vaut status
, que l'attribut value
vaut active
et que la case est cochée, les données envoyées au formulaire contiendront status=active
. Si la case à cocher n'est pas cochée, ses données ne seront pas envoyées avec le formulaire. Pour les cases à cocher et les boutons radio, la valeur par défaut de l'attribut value
est on
.
Exemples
Exemple simple
HTML
<p>Un élément de saisie simple </p>
<input type="text" value="Saisir un texte ici">
Résultat
Un scénario fréquent
HTML
<p>Un formulaire avec différents types de champs</p>
<form action="getform.php" method="get">
<label>Prénom : <input type="text"></label><br>
<label>Nom : <input type="text"></label><br>
<label>Adresse email : <input type="email"></label><br>
<input type="submit" value="Envoyer">
</form>
Résultat
Localisation
Pour certains types d'éléments <input>
, les valeurs saisies autorisées dépendent de la locale utilisée. Ainsi, dans certaines locales, 1,000.00 est un nombre valide alors que dans d'autres, il faudra avoir saisi 1.000,00 pour exprimer le même nombre.
Firefox utilise la méthode heuristique suivante afin de déterminer la locale pour laquelle valider la saisie de l'utilisateur (au moins dans le cas de type="number"
):
- Utiliser la langue définie par l'attribut
lang
/xml:lang
de l'élément ou par celui de ses parents. - Sinon utiliser la langue définie dans l'en-tête HTTP
Content-Language
- Sinon, utiliser la locale du navigateur
Accessibilité
Utilisation de libellés
Lorsqu'on utilise des champs de formulaire, il est recommandé d'ajouter des libellés pour chacun de ces champs. Ainsi, les personnes qui utilisent des outils d'assistance pourront connaître la signification du champ.
Dans l'exemple suivant, on illustre comment associer un élément <label>
avec un élément <input>
. Pour ce faire, on ajoutera un identifiant (un attribut id
) à l'élément <input>
et on référencera cet identifiant via l'attribut for
de l'élément <label>
.
<label for="ptipois">Aimez-vous les petits-pois ?</label> <input type="checkbox" name="petitspois" id="ptipois">
Dimensionnement - taille
Les éléments interactifs tels que les champs de formulaire doivent fournir une surface suffisamment grande pour qu'il soit facile de les activer. Cela facilitera la tâche à une variété de personnes : celles qui ont des problèmes moteur, celles qui utilisent des dispositifs de pointage peu précis (doigt ou stylet). La taille interactive minimale recommandée est de 44x44 pixels CSS.
Notes
Messages personnalisés pour les erreurs
Si on souhaite afficher un message d'erreur personnalisé lors de l'échec de la validation d'un champs, il faudra utiliser les fonctionnalités de contraintes de validation qui sont disponibles sur les éléments <input>
. Par exemple :
<form>
<label for="name">Saisir un nom d'utilisateur (lettres minuscules et majuscules) : </label>
<input type="text" name="name" id="name" required pattern="[A-Za-z]+">
<button>Envoyer</button>
</form>
Les fonctionnalités de validation HTML déclencheront un message d'erreur par défaut si on souhaite envoyer le formulaire avec une valeur invalide (qui ne respecte pas pattern
) ou sans valeur.
Si on souhaite plutôt afficher un message d'erreur personnalisé, on pourra utiliser un fragment de code JavaScript comme celui-ci :
const nameInput = document.querySelector('input');
const form = document.querySelector('form');
nameInput.addEventListener('input', () => {
nameInput.setCustomValidity('');
nameInput.checkValidity();
});
nameInput.addEventListener('invalid', () => {
if(nameInput.value === '') {
nameInput.setCustomValidity("Veuillez saisir votre nom d'utilisateur !");
} else {
nameInput.setCustomValidity("Un nom d'utilisateur ne peut contenir que des lettres minuscules et majuscules, veuillez réessayer");
}
});
Voici le résultat qui pourra être obtenu :
Voici un récapitulatif de la logique de cet exemple :
- On vérifie la validité du champ chaque fois que sa valeur est modifiée en exécutant la méthode
checkValidity()
grâce au gestionnaire d'évènement attaché àinput
. - Si la valeur est invalide, on génère un évènement
invalid
et le gestionnaire d'évènement associé est exécuté. Dans cette fonction, on analyse avec un blocif()
si la valeur est invalide parce qu'elle est vide ou parce qu'elle ne correspond pas au motif désiré. Selon le cas de figure, on utilise le message d'erreur correspondant. - Ainsi, si le champ saisi est invalide, lorsque le bouton Envoyer est utilisé, un des messages d'erreur sera affiché.
- Si la valeur est valide, elle sera envoyée normalement. Pour cela, il faudra annuler la vérification spécifique en appelant
setCustomValidity()
avec une chaîne de caractères vide. On effectue cela à chaque évènementinput
. Sans cette étape, avec une validation spécifique, le champ saisi serait considéré comme invalide même si sa valeur respectait les contraintes exprimées dans le HTML.
Résumé technique
Catégories de contenu | Contenu de flux, contenu de formulaire (listé, envoyable, réinitialisable), contenu phrasé. Si l'attribut type ne vaut pas hidden , c'est un élément étiquetable et tangible. |
---|---|
Contenu autorisé | Aucun, cet élément est un élément vide. |
Omission de balises | Cet élément doit avoir une balise de début et ne pas avoir de balise de fin. |
Parents autorisés | Tout élément qui accepte du contenu phrasé. |
Rôles ARIA autorisés |
|
Interface DOM | HTMLInputElement |
Spécifications
Spécification | État | Commentaires |
---|---|---|
HTML Living Standard La définition de '<input>' dans cette spécification. |
Standard évolutif | |
HTML Media Capture La définition de '<input capture>' dans cette spécification. |
Recommendation | Ajout de l'élément capture |
HTML5 La définition de '<input>' dans cette spécification. |
Recommendation | |
HTML 4.01 Specification La définition de '<form>' dans cette spécification. |
Recommendation |
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
- Les autres éléments relatifs aux formulaires HTML :
<form>
,<button>
,<datalist>
,<legend>
,<label>
,<select>
,<optgroup>
,<option>
,<textarea>
,<keygen>
,<fieldset>
,<output>
,<progress>
et<meter>
. - Dans certains cas, l'élément
<input>
est un élément remplacé, sa position et sa taille dans le cadre de l'élément peuvent être ajustées grâce aux propriétés CSSobject-position
etobject-fit
. - L'objet DOM correspondant :
HTMLInputElement