L'élément HTML <label> représente une légende pour un objet d'une interface utilisateur. Il peut être associé à un contrôle en utilisant l'attribut for ou en plaçant l'élément du contrôle à l'intérieur de l'élément <label>. Un tel contrôle est appelé contrôle étiqueté par l'élément <label>.
| Catégories de contenu | Contenu de flux, contenu phrasé, contenu associé aux formulaires (listed, submittable, resettable), contenu tangible, contenu interactif. |
|---|---|
| Contenu autorisé | Contenu phrasé sans éléments label descendants. À l'exception du contrôle lié à la légende, pas d'autres éléments pouvant contenir un élément label. |
| Omission de balise | Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires |
| Parents autorisés | Tout élément acceptant du contenu phrasé. |
| Rôles ARIA autorisés | Aucun. |
| Interface DOM | HTMLLabelElement |
Attributs
Cet élément inclut les attributs universels.
for- L'identifiant de l'élément de formulaire associé, appartenant au même document que l'élément label. Le premier élément du document dont l'identifiant correspond est alors le contrôle étiqueté par l'élément.
Note : Un élément label peut simultanément avoir un attribut
foret contenir un élément de contrôle tant que l'attributforpointe vers l'élément contenu.
Attributs obsolètes
formHTML5- L'élément de formulaire auquel l'élément label est associé (son formulaire propriétaire). La valeur de cet attribut doit être l'identifiant d'un élément
<form>contenu au sein du même document. Si l'attribut n'est pas renseigné, cet élément <label> doit être le descendant d'un élément<form>. Cet attribut permet de placer des éléments label dans le document sans qu'ils soient nécessairement imbriqués dans un formulaire.Note : La spécification HTML a été mise à jour le 28 avril 2016 afin de déprécier l'attributform. Celui-ci est toujours disponible dans les scripts mais sa définition a changé, il renvoie désormais le contrôle associé au formulaire ounulls'il n'y a pas de contrôle associé (autrement dit siHTMLLabelElement.controlvautnull).
Exemples
Exemple simple
HTML
<label>Cliquez ici<input type="text" id="Utilisateur" name="Nom" /></label>
Résultat
Utiliser l'attribut for
HTML
<label for="Utilisateur">Cliquez ici</label> <input type="text" id="Utilisateur" name="Nom" />
Résultat
Spécifications
| Spécification | État | Commentaires |
|---|---|---|
| HTML Living Standard La définition de '<label>' dans cette spécification. |
Standard évolutif | |
| HTML5 La définition de '<label>' dans cette spécification. |
Recommendation | |
| HTML 4.01 Specification La définition de '<label>' dans cette spécification. |
Recommendation | Définition initiale. |
Compatibilité des navigateurs
Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.
| Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Support simple | Oui | Oui | Oui | Oui | Oui | Oui |
for | Oui | Oui | Oui | Oui | Oui | Oui |
form | Oui | Oui | Oui — 49 | Oui | Oui | Oui |
| Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| Support simple | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
for | Oui | Oui | Oui | Oui | Oui | Oui | Oui |
form | Oui | Oui | Oui | Oui — 49 | Oui | Oui | Oui |
Voir aussi
- Les autres éléments relatifs aux formulaires :
<form>,<input>,<button>,<datalist>,<legend>,<select>,<optgroup>,<option>,<textarea>,<keygen>,<fieldset>,<output>,<progress>et<meter>.

