CKTIS / HTML
label — libellé d’un contrôle
L’élément `label` donne un libellé à un contrôle. Associez-le avec `for` et `id`, ou placez le contrôle à l’intérieur du label.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<label for="control-id">Caption</label>
<input id="control-id">
<label>Caption <input></label>label représente un libellé d’interface utilisateur. Son attribut for cible le id d’un élément pouvant recevoir un libellé dans le même arbre, et non son name. En l’absence de for, le premier descendant pouvant recevoir un libellé est ciblé ; une valeur for invalide ne déclenche pas ce mécanisme de remplacement.
N’imbriquez pas des éléments label et n’ajoutez pas d’autres contrôles pouvant recevoir un libellé à l’intérieur. Un input avec type="hidden" ne peut pas recevoir de libellé. Un contrôle peut avoir plusieurs libellés. Les deux balises label sont nécessaires.
Cliquer sur un libellé peut activer son contrôle, mais le comportement dépend de la plateforme. La propriété DOM label.control renvoie le contrôle associé ou null.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Label association</title>
<label for="email">Email</label>
<input id="email" type="email">
<script>
const label = document.querySelector('label');
const input = document.querySelector('input');
console.log(label.control === input);
</script>
</html>Résultat
true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.