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.