CKTIS / HTML
legend — legenda do grupo
O elemento `legend` apresenta uma legenda para um grupo em `fieldset` ou um rótulo para um grupo de opções em `optgroup`. Tem de ser o primeiro elemento filho e não substitui os rótulos dos controlos individuais.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<fieldset>
<legend>Group caption</legend>
<!-- Group contents -->
</fieldset>Um elemento legend colocado como primeiro elemento filho de fieldset identifica o restante conteúdo do grupo. Utilize-o para uma pergunta comum ou o nome do grupo e utilize label para os controlos individuais.
Ambas as etiquetas são necessárias. O elemento aceita atributos globais. Dentro de fieldset, pode conter conteúdo de frase (phrasing content), como texto e elementos de ênfase, eventualmente intercalado com títulos. Não é um contentor de bloco sem restrições.
legend também é permitido como primeiro elemento filho de optgroup, onde fornece o rótulo do grupo de opções. Nesse contexto, só é permitido conteúdo de frase, sem conteúdo interativo nem descendentes com um atributo tabindex.
Quando um fieldset tem disabled, essa desativação não abrange os controlos dentro do seu primeiro elemento filho legend; outras causas podem, ainda assim, desativá-los. A propriedade DOM só de leitura legend.form devolve o formulário do fieldset ascendente ou null; sem esse elemento ascendente, também devolve null.
Exemplos
<!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>Resultado
Contact method preferences
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.