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

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 !

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 valeur
• color : 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'attribut accept 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'attribut src doit être défini avec la source de l'image et l'attribut alt doit être défini avec le texte alternatif. Les attributs height et width 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 attributs maxlength et minlength 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.

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.

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.

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 Attribut HTML : 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).

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.

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 (en-US) et ne sont pas envoyés avec le formulaire.

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.

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.

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.

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.

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).

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 attribut tabindex 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.

HTML

<p>Un élément de saisie simple </p>
<input type="text" value="Saisir un texte ici">

Résultat

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

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

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">

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.

• Comprendre le critère d'accessibilité 2.5.5 sur la taille des cibles - Comprendre WCAG 2.1 (en anglais)
• Taille des cibles et critère 2.5.5, billet en anglais de Adrian Roselli
• Test rapide : cibles tactiles suffisamment grande - Projet A11Y (billet en anglais)

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() (en-US) 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 bloc if() 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ènement input. 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.

• 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 CSS object-position et object-fit.
• L'objet DOM correspondant : HTMLInputElement