CKTIS / HTML
legend — didascalia del gruppo
L’elemento `legend` fornisce una didascalia a un gruppo in `fieldset` o un’etichetta a un gruppo di opzioni in `optgroup`. Deve essere il primo elemento figlio e non sostituisce le etichette dei singoli controlli.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<fieldset>
<legend>Group caption</legend>
<!-- Group contents -->
</fieldset>Un elemento legend collocato come primo elemento figlio di fieldset descrive il resto del contenuto del gruppo. Usalo per una domanda condivisa o il nome del gruppo e usa label per i singoli controlli.
Entrambi i tag sono necessari. L’elemento accetta attributi globali. All’interno di fieldset può contenere contenuto di frase, come testo ed enfasi, eventualmente intervallati da intestazioni. Non è un contenitore di blocco senza restrizioni.
legend è consentito anche come primo elemento figlio di optgroup, dove fornisce l’etichetta del gruppo di opzioni. In questo contesto è ammesso solo contenuto di frase, senza contenuto interattivo né discendenti con un attributo tabindex.
Quando un fieldset ha disabled, la disattivazione non si applica ai controlli contenuti nel suo primo elemento figlio legend; altre cause possono comunque disattivarli. La proprietà DOM di sola lettura legend.form restituisce il modulo del fieldset genitore oppure null; anche in assenza di tale genitore restituisce null.
Esempi
<!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>Risultato
Contact method preferences
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.