CKTIS / HTML
Attribut label — un nom visible par l’utilisateur
L’attribut label nomme un groupe optgroup, une option ou une piste track. Ce n’est ni un attribut global ni un remplacement de l’élément label. Le libellé d’une option et la valeur envoyée avec le formulaire sont deux notions distinctes.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
label="text"label est un attribut textuel des éléments optgroup, option et track, et non un attribut global. Ne le confondez pas avec l’élément label, qui sert à nommer un contrôle de formulaire.
Sur optgroup, il nomme un groupe d’options ; le groupe lui-même ne peut pas être sélectionné. L’attribut est obligatoire lorsque le groupe n’a pas d’enfant legend. Lorsque le premier enfant de type élément est legend, son texte prime sur l’attribut.
Sur option, un attribut label non vide fournit le libellé ; sinon, celui-ci provient du contenu de l’option. L’attribut ne doit pas être vide lorsqu’il est indiqué. Il ne remplace pas value : en l’absence de value, la valeur provient du contenu, et non de label. Lorsque label et value sont tous deux indiqués, l’élément option doit être vide. L’élément selectedcontent ne reflète pas la valeur de l’attribut label.
Sur track, l’attribut fournit un titre de piste lisible dans l’interface du lecteur. Il est facultatif, mais ne doit pas être vide lorsqu’il est indiqué ; sans lui, le libellé de la piste est une chaîne vide. Il ne précise pas la langue — c’est le rôle de srclang. Les pistes d’un même élément média ayant le même type et la même langue ne doivent pas avoir des libellés identiques ni omettre toutes deux leur libellé.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Label attribute</title>
<label for="fruit">Fruit</label>
<select id="fruit" name="fruit">
<optgroup label="Citrus">
<option label="Orange" value="orange" selected></option>
</optgroup>
</select>
<pre id="result"></pre>
<script>
const select = document.getElementById('fruit');
const option = select.options[0];
document.getElementById('result').textContent =
option.label + '\n' + select.value;
</script>
</html>Résultat
Orange orange
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.