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

CKTIS / HTML

closedby: decidir como pode fechar-se uma caixa de diálogo

Separa o fecho automático dos controlos explícitos da aplicação.

Versão: HTML Living Standard

Sintaxe

<dialog closedby="none">...</dialog>

Numa caixa de diálogo, closedby escolhe as ações automáticas de fecho permitidas. any inclui cliques no exterior e pedidos de fecho; closerequest inclui pedidos como Escape, mas não o fecho por clique no exterior; none desativa o fecho automático por ações do utilizador. Valores ausentes ou inválidos usam o estado automático: um diálogo modal permite pedidos de fecho, enquanto um não modal não fecha automaticamente.

Isto não desativa ações deliberadas da aplicação. Tanto close() como requestClose() continuam disponíveis; o segundo emite o evento de cancelamento anulável e ignora a restrição closedby. Disponibiliza sempre uma saída explícita acessível quando desativares o fecho automático. Não removas manualmente o atributo open para substituir os métodos de fecho adequados.

O ambiente de teste abre um diálogo modal, prime Escape com o fecho desativado, altera a definição e prime Escape novamente. Chromium 145 manteve o diálogo aberto na primeira tentativa e fechou-o no segundo pedido. O exemplo verifica a capacidade DOM e conserva um botão explícito de fecho; não se deve presumir que este atributo recente funciona em todos os navegadores.

Exemplos

<!doctype html><meta charset="utf-8">
<dialog id="dialog" closedby="none"><p>Press Escape twice.</p><button id="exit" type="button">Close explicitly</button></dialog>
<output id="result"></output><script>
const dialog = document.querySelector('#dialog');
document.querySelector('#exit').onclick = () => dialog.close();
if (!('closedBy' in dialog)) {
  document.querySelector('#result').textContent = 'closedby unsupported; explicit close remains available';
} else {
  let count = 0, firstOpen;
  document.addEventListener('keydown', event => {
    if (event.key !== 'Escape') return;
    count += 1;
    if (count === 1) setTimeout(() => { firstOpen = dialog.open; dialog.closedBy = 'closerequest'; }, 0);
  });
  dialog.addEventListener('close', () => {
    document.querySelector('#result').textContent = 'none-open=' + firstOpen + '; closerequest-open=' + dialog.open;
  });
}
dialog.showModal();
</script>

Resultado

none-open=true; closerequest-open=false

O teste envia dois eventos de teclado reais para a página isolada e verifica o estado aberto após cada um.

Fontes