<label>

Résumé

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 balises Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires
• Élément parents autorisés Tout élément acceptant du contenu phrasé.
• Interface DOM HTMLLabelElement

Attributs

Cet élément inclut les attributs globaux.

accesskey HTML 4 HTML5

Une touche de raccourci pour accéder à cet élément grâce au clavier.

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 for et contenir un élément de contrôle tant que l'attribut for pointe vers l'élément contenu.

form HTML5

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.

Exemple

Exemple simple

<label>Clique ici<input type="text" id="Utilisateur" name="Nom" /></label>

Exemple avec l'attribut for

<label for="Utilisateur">Clique ici</label>
<input type="text" id="Utilisateur" name="Nom" />

Spécifications

Compatibilité des navigateurs

Note

Événements de clic dans les éléments <label> imbriqués

À partir de Gecko 8.0 (Firefox 8.0 / Thunderbird 8.0 / SeaMonkey 2.5), un événement de clic qui « bouillonne » (bubbling) déclenche au plus un élément <label>, le clic synthétique ne peut pas déclencher d'éléments <label> supplémentaires. Sous Gecko, un événement de clic bouillonera toujours après un élément <label>, sous Webkit ou Internet Explorer, l'événement de clic s'arrêtera avec l'élément <label>. Le comportement antérieur à Gecko 8.0 (déclenchant plusieurs éléments <label>) faisait planter Firefox (voir  bug 646157).