Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

closedby: decidere come può chiudersi un dialogo

Separa la chiusura automatica dai controlli espliciti dell’applicazione.

Versione: HTML Living Standard

Sintassi

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

Su un dialogo, closedby sceglie le azioni automatiche di chiusura consentite. any include clic esterni e richieste di chiusura; closerequest include richieste come Escape ma non la chiusura tramite clic esterno; none disabilita la chiusura automatica dovuta ad azioni dell’utente. Valori assenti o non validi usano lo stato automatico: un dialogo modale consente richieste di chiusura, uno non modale non si chiude automaticamente.

Questo non disabilita le azioni deliberate dell’applicazione. Sia close() sia requestClose() restano disponibili; il secondo genera l’evento di annullamento annullabile e ignora la restrizione closedby. Offri sempre un’uscita esplicita accessibile quando disabiliti la chiusura automatica. Non rimuovere manualmente l’attributo open per sostituire i metodi di chiusura appropriati.

L’ambiente di prova apre un dialogo modale, preme Escape mentre la chiusura è disabilitata, cambia l’impostazione e preme di nuovo Escape. Chromium 145 ha mantenuto aperto il dialogo al primo tentativo e lo ha chiuso alla seconda richiesta. L’esempio controlla la capacità DOM e conserva un pulsante di chiusura esplicito; non bisogna presumere che questo attributo recente funzioni in ogni browser.

Esempi

<!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>

Risultato

none-open=true; closerequest-open=false

Il test invia due veri eventi di tastiera alla pagina isolata e verifica lo stato di apertura dopo ciascuno.

Fonti