<legend> : l'élément de légende de groupe de champs
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
L'élément HTML <legend> représente une légende pour le contenu de son parent <fieldset>.
Dans les éléments <select> personnalisables, l'élément <legend> est autorisé comme enfant de <optgroup>, afin de fournir un libellé facile à cibler et à mettre en forme. Cela remplace tout texte défini dans l'attribut label de l'élément <optgroup>, et possède la même sémantique.
Exemple interactif
<fieldset>
<legend>Choose your favorite monster</legend>
<input type="radio" id="kraken" name="monster" value="K" />
<label for="kraken">Kraken</label><br />
<input type="radio" id="sasquatch" name="monster" value="S" />
<label for="sasquatch">Sasquatch</label><br />
<input type="radio" id="mothman" name="monster" value="M" />
<label for="mothman">Mothman</label>
</fieldset>
legend {
background-color: black;
color: white;
padding: 3px 6px;
}
input {
margin: 0.4rem;
}
Attributs
Cet élément inclut uniquement les attributs universels.
Exemples
Voir <form> pour des exemples utilisant <legend>.
Résumé technique
| Catégories de contenu | Aucune. |
|---|---|
| Contenu autorisé | Contenu phrasé et titres (éléments h1 à h6). |
| Omission de balises | Aucune, la balise ouvrante et la balise fermante doivent être présentes. |
| Parents autorisés |
Un élément <fieldset> dont le premier élément
fils est cet élément <legend>.
In éléments sélection personnalisables, un élément <legend> est autorisé comme enfant de <optgroup>.
|
| Rôle ARIA implicite | Pas de rôle correspondant (angl.) |
| Rôles ARIA autorisés | Aucun role autorisé |
| Interface DOM | HTMLLegendElement |
Spécifications
| Specification |
|---|
| HTML # the-legend-element |