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

CKTIS / HTML

open — o estado de abertura de details e dialog

O atributo booleano open controla se details está expandido ou se dialog está aberto. O que conta é a presença do atributo, não o valor textual; open, por si só, não cria uma caixa de diálogo modal.

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

Sintaxe

<details open>…</details>
<dialog open>…</dialog>
open | open="" | open="open"

open é um atributo booleano de details e dialog, não um atributo global. As formas válidas são open, open="" e open="open". Escrever open="false" é inválido e, ainda assim, mantém o atributo presente; para obter o estado falso, é necessário omiti-lo.

Em details, open revela conteúdo adicional junto de summary; sem o atributo, só aparece o resumo. Ativar summary alterna o atributo. A propriedade DOM open reflete a sua presença.

Em dialog, open abre, por si só, uma caixa de diálogo não modal; para que seja modal, é necessário showModal(). Fecha-a com close() em vez de remover manualmente o atributo: a remoção manual ignora o evento close e, após showModal(), pode deixar o documento bloqueado.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>open attribute</title>
<details open>
  <summary>Details</summary>
  <p>Additional information.</p>
</details>
<dialog open>
  <p>Non-modal dialog.</p>
</dialog>
<pre id="result"></pre>
<script>
  const details = document.querySelector('details');
  const dialog = document.querySelector('dialog');
  const states = [`${details.open} ${dialog.open}`];
  details.open = false;
  dialog.close();
  states.push(`${details.open} ${dialog.open}`);
  document.getElementById('result').textContent = states.join('\n');
</script>
</html>

Resultado

true true
false false

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.

Fontes