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