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.
<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 :
{{HTMLElement("input/button", "button")}} : un bouton sans comportement défini.{{HTMLElement("input/checkbox", "checkbox")}} : une case à cocher qui permet de sélectionner/déselectionner une valeur{{HTMLElement("input/color", "color")}} : {{HTMLVersionInline("5")}} un contrôle qui permet de définir une couleur.{{HTMLElement("input/date", "date")}} : {{HTMLVersionInline("5")}} un contrôle qui permet de saisir une date (composé d'un jour, d'un mois et d'une année).{{HTMLElement("input/datetime-local", "datetime-local")}} : {{HTMLVersionInline("5")}} un contrôle qui permet de saisir une date et une heure (sans fuseau horaire).{{HTMLElement("input/email", "email")}} : {{HTMLVersionInline("5")}} un champ qui permet de saisir une adresse éléctronique.{{HTMLElement("input/file", "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.{{HTMLElement("input/hidden", "hidden")}} : un contrôle qui n'est pas affiché mais dont la valeur est envoyée au serveur.{{HTMLElement("input/image", "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.{{HTMLElement("input/month", "month")}} : {{HTMLVersionInline("5")}} un contrôle qui permet de saisir un mois et une année (sans fuseau horaire).{{HTMLElement("input/number", "number")}} : {{HTMLVersionInline("5")}} un contrôle qui permet de saisir un nombre.{{HTMLElement("input/password", "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.
{{HTMLElement("input/radio", "radio")}} : un bouton radio qui permet de sélectionner une seule valeur parmi un groupe de différentes valeurs.{{HTMLElement("input/range", "range")}} : {{HTMLVersionInline("5")}} un contrôle qui permet de saisir un nombre dont la valeur exacte n'est pas importante.{{HTMLElement("input/reset", "reset")}} : un bouton qui réinitialise le contenu du formulaire avec les valeurs par défaut.{{HTMLElement("input/search", "search")}} : {{HTMLVersionInline("5")}} un champ texte sur une ligne pour des termes de recherche. Les sauts de ligne sont automatiquement retirés.{{HTMLElement("input/submit", "submit")}} : un bouton qui envoie le formulaire.{{HTMLElement("input/tel", "tel")}} : {{HTMLVersionInline("5")}} un contrôle pour saisir un numéro de téléphone.{{HTMLElement("input/text", "text")}} : un champ texte sur une seule ligne. Les sauts de ligne sont automatiquement retirés.{{HTMLElement("input/time", "time")}} : {{HTMLVersionInline("5")}} A control for entering a time value with no time zone.{{HTMLElement("input/url", "url")}} : {{HTMLVersionInline("5")}} un champ permettant de saisir une URL.{{HTMLElement("input/week", "week")}} : {{HTMLVersionInline("5")}} 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 :
{{HTMLElement("input/datetime", "datetime")}} : {{HTMLVersionInline("5")}} {{deprecated_inline}} {{obsolete_inline}} 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 {{domxref("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.
Note : Les éléments <input> peuvent bien entendu utiliser les attributs universels.
| Attribut | Description |
|---|---|
{{anch("autocomplete")}} |
Une chaîne de caractères qui indique le type d'autocomplétion à utiliser. |
{{anch("autofocus")}} |
Un attribut booléen qui passe le focus sur le champ lorsque le formulaire est affiché. |
{{anch("disabled")}} |
Un attribut booléen qui indique si le champ doit être désactivé. |
{{anch("form")}} |
L'identifiant du formulaire (la valeur de l'attribut id de l'élément {{HTMLElement("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. |
{{anch("list")}} |
L'identifiant (valeur de l'attribut id) d'un élément {{HTMLElement("datalist")}} qui fournit une liste de suggestions. |
{{anch("name")}} |
Le nom du champ qui sera rattaché à la donnée envoyée via le formulaire. |
{{anch("readonly")}} |
Un attribut booléen qui indique si le champ peut être édité ou non. |
{{anch("required")}} |
Un attribut booléen qui indique que le champ doit être renseigné avant de pouvoir envoyer le formulaire. |
{{anch("tabindex")}} |
Une valeur numérique qui indique à l'agent utilisateur l'ordre selon lequel naviguer au clavier grâce à la touche Tab. |
{{anch("type")}} |
Une chaîne de caractère qui indique le type de champ représenté par l'élément <input>. |
{{anch("value")}} |
La valeur du champ. |
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 {{SectionOnPage("/fr/docs/Web/HTML/Attributs/autocomplete", "Valeurs")}} 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.
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 ({{HTMLElement("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 {{domxref("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.
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 {{event("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 {{htmlattrxref("autocomplete","input")}} pourra être utilisé afin de contrôler cette fonctionnalité.
Une chaîne de caractères qui indique l'élément {{HTMLElement("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 {{htmlattrxref("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.
Cet attribut est une chaîne de caractères qui correspond à l'identifiant ({{domxref("Element.id", "id")}}) d'un élément {{HTMLElement("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.
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 {{domxref("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 {{domxref("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.
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.
Note : 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.
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 {{cssxref(":required")}} lui est appliqué. À l'inverse, les champs qui n'ont pas d'attribut required auront la pseudo-classe {{cssxref(":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 {{htmlattrxref("readonly", "input/text")}}.
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 :
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.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.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.
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.
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 {{domxref("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.
<p>Un élément de saisie simple </p> <input type="text" value="Saisir un texte ici">
{{EmbedLiveSample('Exemple_simple', '', '100')}}
<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>
{{EmbedLiveSample('Un_scénario_fréquent', '', '200')}}
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"):
lang/xml:lang de l'élément ou par celui de ses parents.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.
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 :
{{EmbedLiveSample("Messages_personnalisés_pour_les_erreurs")}}
Voici un récapitulatif de la logique de cet exemple :
checkValidity() grâce au gestionnaire d'évènement attaché à input.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.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.| Catégories de contenu | Contenu de flux, contenu de formulaire (listé, envoyable, réinitialisable), contenu phrasé. Si l'attribut {{htmlattrxref("type", "input")}} 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 | {{domxref("HTMLInputElement")}} |
| Spécification | État | Commentaires |
|---|---|---|
| {{SpecName('HTML WHATWG', 'forms.html#the-input-element', '<input>')}} | {{Spec2('HTML WHATWG')}} | |
| {{SpecName('HTML Media Capture', '#the-capture-attribute','<input capture>')}} | {{Spec2('HTML Media Capture')}} | Ajout de l'élément capture |
| {{SpecName('HTML5 W3C', 'forms.html#the-input-element', '<input>')}} | {{Spec2('HTML5 W3C')}} | |
| {{SpecName('HTML4.01', 'interact/forms.html#h-17.4', '<form>')}} | {{Spec2('HTML4.01')}} |
{{Compat("html.elements.input")}}
<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 {{cssxref("object-position")}} et {{cssxref("object-fit")}}.