Faire son site 12 : Référence HTML 5 - <input>

<input></input>

La balise <input> crée un contrôle qui permet à l'utilisateur de saisir des données. Le comportement de ce contrôle dépend beaucoup de son attribut type. La balise <input> accepte de très nombreux attributs.

Attribut Valeur Commentaire
type Sans valeur, équivaut à text
button Bouton sans comportement particulier
checkbox Case à cocher. L'attribut value doit être utilisé pour indiquer la valeur correspondant à l'élément.
color Permet de renvoyer une couleur sous forme d'un texte
date Permet de saisir une date (sans l'heure)
datetime-local Permet de saisir une date et une heure sans fuseau horaire associé
email Permet de saisir une adresse email. La saisie est validée si l'adresse est valide ou si la chaîne est vide.
Les pseudo-classes CSS :valid et :invalid sont utilisées si nécessaire.
file Permet de sélectionner un fichier. L'attribut accept peut être utilisé pour définir le type de fichier
hidden Le contrôle n'est pas affiché mais sa valeur est renvoyée au serveur
image Un bouton d'envoi. Les attributs src et alt doivent être spécifiés.
On peut également renseigner les attributs width et height.
month Permet de saisir un mois et une année sans fuseau horaire.
number Permet de saisir un nombre décimal.
password Permet de saisir un mot de passe. Les caractères ne sont pas affichés.
On peut utiliser l'attribut maxlength pour limiter la longueur de la saisie
radio Un bouton radio. L'attribut value doit être renseigné pour indiquer la valeur associée à cet élément.
On peut utiliser l'attribut checked pour présélectionner cet élément.
Si plusieurs boutons radio ont même attribut name, ils appartiendront au même groupe.
range Permet de saisir un nombre dont la valeur exacte n'a pas d'importance.
Si les attributs suivants ne sont pas renseignés, les valeurs suivantes seront utilisées
  • min: 0
  • max: 100
  • value : min + (max - min) / 2, ou min si max est inférieur à min
  • step: 1
reset Réinitialise les champs du formulaire à ses valeurs par défaut.
search Un champ texte sur une seule ligne permettant de saisir des requêtes de recherche.
submit Un bouton qui envoie le formulaire.
tel Permet de saisir un numéro de téléphone. Les attributs pattern et maxlength peuvent être utilisés de
même que les pseudo classes :valid et :invalid.
text Une zone de texte sur une seule ligne. Les passages à la ligne sont supprimés.
time Permet de saisir une heure sans fuseau horaire associé.
url Un champ qui permet d'éditer une URL.
La valeur saisie est valide si c'est la chaîne de caractères vide ou si c'est une URL absolue valide.
week Un contrôle qui permet de saisir une semaine sous la forme d'un numéro de semaine, sans fuseau horaire associé.
accept Si l'attribut type vaut file, cet attribut indiquera les types de fichiers acceptés par le serveur
(pour les autres types, cet attribut sera ignoré)
Chaque type de fichier est indiqué par son extension (.doc, .jpg etc.) ou par un type MIME valide.
audio, video et image sont directement reconnus.
autocomplete Indique si le champ doit être complété par le navigateur
off Aucune auto-complétion n'est effectuée par le navigateur.
on Le champ peut être complété par les valeurs précédemment saisies dans le formulaire
name Un nom complet
honorific-prefix Une civilité ou un titre (Mr, Mme, Dr
given-name Un prénom
additional-name Un deuxième prénom
Family-name Un nom de famille
honorific-suffix Un complément de nom (Junior, Dit Untel)
nickname Un surnom
email Une adresse électronique
username Un nom d'utilisateur
new-password Un nouveau mot de passe (par exemple lorsqu'on le change)
current-password Un mot de passe en cours de validité
organization-title Un titre dans l'entreprise
organization Un nom de société
street-address Un numéro d'adresse
address-line1
address-line2
address-line3
address-level4
address-level3
address-level2
address-level1
Des compléments d'adresse
country-name Un nom de pays
postal-code Un code postal
cc-name Un nom complet tel qu'indiqué sur un moyen de paiement
cc-given-name Un nom usuel tel qu'indiqué sur un moyen de paiement
cc-additional-name Un nom additionnel tel qu'indiqué sur un moyen de paiement
cc-family-name Un nom de famille tel qu'indiqué sur un moyen de paiement
cc-number Un code identifiant le moyen de paiement (le numéro d'une carte de crédit par exemple)
cc-exp Une date d'expiration du moyen de paiement
cc-exp-month Le mois d'expiration du moyen de paiement
cc-exp-year L'année d'expiration du moyen de paiement
cc-csc Le code de sécurité du moyen de paiement
cc-type le type de moyen de paiement (par exemple : Visa)
transaction-currency Monnaie utilisée pour la transaction
transaction-amount Montant de la transaction
language La langue utilisée
bday Une date d'anniversaire
bday-day Un jour anniversaire
bday-month Un mois anniversaire
bday-year Une année anniversaire
sex Un texte libre sans retour à la ligne
tel Un numéro de téléphone
url Une url en rapport avec l'entreprise ou la personne dont il est question.
photo Une photo de la personne, de l'entreprise ou bien de l'adresse
autofocus -- Indique que l'élément reçoit le focus au chargement du document.
Un seul élément du document peut avoir cet attribut.
Cet élément doit appartenir à un formulaire et son type ne doit pas être hidden.
capture -- Lorsque l'attribut type vaut file, la présence de cet attribut booléen indique qu'il faut, si possible,
utiliser un périphérique de capture de l'appareil plutôt qu'un explorateur de fichiers.
checked -- Lorsque l'attribut type vaut radio ou checkbox, indique que l'élément est sélectionné par défaut.
disabled -- L'élément est désactivé, aucune action n'est possible dessus.
form Fait référence à l'attribut id de l'élément <form> auquel l'élément est rattaché.
Si l'attribut n'est pas mentionné l'élément doit être le descendant d'un élément <form>.
formaction L'URI du programme qui traite l'information transmise par l'élément <input> si celui-ci est un bouton d'envoi ou une image.
Si cet attribut est utilisé, sa valeur surcharge celle de l'attribut action du formulaire associé..
formenctype Si l'élément <input> est un bouton d'envoi ou une image, cet attribut définit le type de contenu utilisé pour envoyer
le formulaire au serveur. Les valeurs possibles pour cet attribut sont :
  • application/x-www-form-urlencoded : la valeur par défaut si l'attribut n'est pas défini
  • multipart/form-data : cette valeur doit être utilisée lorsque l'attribut type vaut file
  • text/plain
Si cet attribut est utilisé, il surcharge l'attribut enctype de l'élément <form> associé.
formmethod Si l'élément <input> est un bouton d'envoi ou une image, cet attribut définit la méthode HTTP utilisée par le navigateur
pour transmettre le formulaire. Les valeurs possibles :
  • post Les données du formulaire sont incluses dans le corps du formulaire et sont envoyées au serveur.
  • get Les données du formulaire sont ajoutées après l'URI de l'attribut form, séparées par des points d'interrogation.
    L'URI ainsi obtenue est envoyée au serveur.
    Cette méthode doit uniquement être utilisée lorsque le formulaire n'a aucun effet de bord
    et qu'il ne contient que des caractères ASCII
formnovalidate Si l'élément <input> est un bouton d'envoi ou une image, cet attribut booléen indique que le formulaire
ne doit pas être validé avant l'envoi. Si cet attribut est utilisé, sa valeur surcharge celle de l'attribut novalidate du formulaire associé.
height Si la valeur de l'attribut type vaut image, cet attribut définit la hauteur de l'image affichée sur le bouton.
inputmode Une indication destinée au navigateur pour le clavier qui doit être affiché.
Cet attribut s'applique uniquement lorsque l'attribut type vaut text, password, email, ou url. Les valeurs possibles pour cet attribut sont:
  • verbatim Un clavier alphanumérique pour les textes hors prose comme les noms d'utilisateur et les mots de passe.
  • latin Un clavier pour les langues utilisant l'alphabet latin et avec des aides à la saisie (comme la prédiction des termes).
    Ce clavier est destiné aux textes pour les interactions homme-ordinateur
  • latin-name Semblable à latin mais pour la saisie de noms propres
  • latin-prose Semblable à latin mais avec une aide à la saisie plus importante.
  • full-width-latin Semblable à latin-prose, mais pour les langues secondaires de l'utilisateur.
  • kana Un clavier destiné à saisir des textes en japonais.
  • katakana Un clavier destiné à saisir des textes en japonais.
  • numeric Un clavier numérique destiné à la saisie de codes numériques (par exemple le numéro d'une carte de crédit).
  • tel Un clavier destiné à saisir un numéro de téléphone. Si possible, on utilisera le type tel plutôt que cette valeur.
  • email Un clavier destiné à saisir une adresse électronique. Si possible, on utilisera le type email plutôt que cette valeur.
  • url Un clavier destiné à saisir une URL. Si possible, on utilisera le type url plutôt que cette valeur.
list Une liste d'options prédéfinies. La valeur de cet attribut est l'id d'un élémént <datalist>.
max La valeur maximale de l'élément. Cette valeur ne doit pas être inférieure à l'attribut min.
maxlength Lorsque l'attribut type vaut text, email, search, password, tel ou url, cet attribut définit
le nombre maximal de caractères que l'utilisateur peut saisir.
min La valeur minimale de l'élément. Cette valeur ne doit pas être supérieure à l'attribut max.
minlength Lorsque l'attribut type vaut text, email, search, password, tel ou url, cet attribut définit
le nombre minimal de caractères que l'utilisateur doit saisir.
multiple -- Cet attribut booléen indique que l'utilisateur peut saisir plus d'une valeur. Cet attribut est appliqué lorsque type vaut email ou file.
name Le nom du contrôle, envoyé avec les données lors de l'envoi du formulaire.
pattern Une expression rationnelle qui permet de vérifier la valeur saisie.
L'expression doit correspondre à la valeur entière.
L'attribut title peut être utilisé pour décrire le motif et aider l'utilisateur.
Cet attribut est appliqué lorsque type vaut text, search, tel, url, email ou password.
placeholder Une indication, destinée à l'utilisateur, pour ce qui peut être saisi dans le contrôle.
Le texte de cet attribut ne doit pas contenir de saut de ligne.
readonly -- Cet attribut indique que l'utilisateur ne peut pas modifier la valeur du contrôle.
La valeur de cet attribut est ignorée lorsque l'attribut type vaut hidden, range, color, checkbox, radio, file, button ou submit.
required -- Cet attribut indique que la valeur doit être renseignée avant que l'utilisateur puisse envoyer le formulaire.
Il ne peut pas être utilisé lorsque l'attribut type vaut hidden, image ou est un bouton (submit, reset, button).
Les pseudo-classes CSS :optional et :required seront appliquées si nécessaire.
selectiondirection none La direction de la sélection est inconnue.
forward La sélection est appliquée dans le sens d'écriture (qui peut varier selon la langue locale).
backward La sélection est appliquée dans le sens inverse du sens d'écriture.
selectionend Le décalage entre le contenu de l'élément et le dernier caractère sélectionné.
S'il n'y a aucune sélection, la valeur indique la position du caractère qui suit le curseur de saisie.
selectionstart Le décalage entre le contenu de l'élément et le premier caractère sélectionné.
S'il n'y a aucune sélection, la valeur indique la position du caractère qui suit le curseur de saisie.
size La taille initiale du contrôle.
Cette valeur est exprimée en pixels, sauf lorsque l'attribut type vaut text ou password, auquel cas,
la valeur correspond au nombre de caractères. À partir de HTML5, cet attribut ne s'applique que si l'attribut type
vaut text, search, tel, url, email ou password, sinon il est ignoré.
La valeur de size doit être supérieure à zéro.
Si aucune taille n'est indiquée, c'est 20 qui est utilisé par défaut.
spellcheck Cet attribut permet de gérer la vérification orthographique et grammaticale du contenu.
Lorsqu'il vaut true, la vérification est activée.
S'il vaut default, c'est le comportement par défaut qui s'applique,
éventuellement dicté par la valeur de l'attribut spellcheck de l'élément parent.
S'il vaut false, l'orthographe et la grammaire de la valeur ne doivent pas être vérifiées.
src Si la valeur de l'attribut type vaut image, cet attribut indique l'URI de l'emplacement de l'image à afficher sur le bouton.
Dans les autres cas, cet attribut est ignoré.
step Cet attribut fonctionne avec les attributs min et max et permet de définir l'incrément utilisé pour passer d'une valeur à l'autre
(dans le cas d'une valeur numérique ou d'une date).
Cet attribut peut valoir la chaîne de caractères any ou un nombre décimal positif.
Si la valeur de cet attribut est différente de any, le contrôle acceptera uniquement les valeurs
qui sont des multiples de l'incrément et qui sont supérieures au minimum fourni par min.
value La valeur initiale du contrôle. Cet attribut est optionnel sauf lorsque l'attribut type vaut radio ou checkbox.
width Si la valeur de l'attribut type est image, cet attribut définit la largeur de l'image affichée dans le bouton de saisie.

Vous pouvez voir la mise en place d'un formulaire simple en état de marche sur la page Les formulaires.