Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
<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émentHTML<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'attributlabel 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" name="monster" value="K" /> <label for="kraken">Kraken</label><br /> <input type="radio" name="monster" value="S" /> <label for="sasquatch">Sasquatch</label><br /> <input type="radio" 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 lesattributs universels.
Exemples
Voir<form> pour des exemples utilisant<legend>.
Résumé technique
| Catégories de contenu | Aucune. |
|---|---|
| Contenu autorisé | Contenu phrasé ettitres (é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 | Aucunrole autorisé |
| Interface DOM | HTMLLegendElement |
Spécifications
| Specification |
|---|
| HTML # the-legend-element |