CKTIS / HTML
legend — légende de groupe
L’élément `legend` donne une légende à un groupe dans `fieldset` ou à un groupe d’options dans `optgroup`. Il doit être le premier enfant élément et ne remplace pas les libellés des contrôles individuels.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<fieldset>
<legend>Group caption</legend>
<!-- Group contents -->
</fieldset>Un élément legend placé en premier enfant élément de fieldset légende le reste du contenu du groupe. Utilisez-le pour une question commune ou un nom de groupe, et utilisez label pour les contrôles individuels.
Les deux balises sont requises. L’élément accepte les attributs globaux. Dans fieldset, il peut contenir du contenu phrasé, comme du texte et des mises en évidence, éventuellement mêlés à des titres. Ce n’est pas un conteneur de bloc sans restriction.
legend est également autorisé comme premier enfant élément de optgroup, où il fournit le libellé du groupe d’options. Dans ce contexte, seul le contenu phrasé est permis, sans contenu interactif ni descendant doté d’un attribut tabindex.
Lorsqu’un fieldset a l’attribut disabled, cette désactivation ne concerne pas les contrôles situés dans son premier enfant legend ; d’autres causes peuvent toutefois les désactiver. La propriété DOM en lecture seule legend.form renvoie le formulaire du fieldset parent ou null ; en l’absence d’un tel parent, elle renvoie également null.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Legend example</title>
<form id="preferences">
<fieldset>
<legend id="caption">Contact method</legend>
<label><input type="radio" name="contact" value="email" checked> Email</label>
<label><input type="radio" name="contact" value="phone"> Phone</label>
</fieldset>
</form>
<script>
const caption = document.getElementById('caption');
console.log(caption.textContent);
console.log(caption.form.id);
</script>
</html>Résultat
Contact method preferences
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.