Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

termo ou valor HTML: hidden

O atributo `hidden` marca conteúdo que atualmente não deve ser apresentado; um estado especial permite ao navegador revelar um fragmento encontrado na página.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<section hidden>…</section>

hidden é um atributo enumerado. O estado oculto abrange o valor vazio, a palavra hidden e valores inválidos, enquanto until-found escolhe oculto até ser encontrado; a ausência permite apresentação normal.

Escrever hidden="false" não desativa a ocultação, pois false não é esse token e passa ao estado hidden. Remove o atributo para mostrar o elemento; não anules a semântica com um estilo de autor que force a renderização.

No estado localizável o navegador pode encontrar texto, emitir beforematch, remover hidden e deslocar-se ao conteúdo. Conteúdo normalmente oculto não é renderizado nem exposto como acessível, mas permanece no DOM, pelo que isto não protege segredos.

O exemplo lê a propriedade hidden como true, o display calculado como none, enquanto document.body.contains() ainda confirma a presença na árvore. Suprimir a apresentação não remove o nó.

Exemplos

<!doctype html><meta charset="utf-8"><section id="x" hidden>Secret</section><output id="result"></output><script>result.textContent=`hidden=${x.hidden}; display=${getComputedStyle(x).display}; inDom=${document.body.contains(x)}`;</script>

Resultado

hidden=true; display=none; inDom=true

O exemplo executado verifica em simultâneo a ausência de renderização e a permanência do elemento oculto no DOM.

Fontes