CKTIS / HTML
closedby: povolené způsoby zavření dialogu
Oddělte automatické zavírání od výslovných ovládacích prvků aplikace.
Verze: HTML Living Standard
Syntaxe
<dialog closedby="none">...</dialog>U dialogu closedby volí povolené automatické způsoby zavření. any zahrnuje kliknutí mimo dialog i požadavky na zavření; closerequest zahrnuje požadavky jako Escape, ale ne kliknutí venku; none automatické zavření uživatelským gestem zakazuje. Chybějící či neplatná hodnota dává automatický stav: modální dialog dovoluje požadavky na zavření, nemodální se automaticky nezavírá.
To nezakazuje záměrné akce aplikace. Dostupné zůstávají close() i requestClose(); druhá metoda vyvolá zrušitelnou událost zrušení a omezení closedby ignoruje. Pokud automatické zavření vypnete, vždy poskytněte přístupný výslovný způsob odchodu. Ruční odstranění atributu otevření nenahrazuje správné metody zavírání.
Test otevře modální dialog, stiskne Escape při zakázaném zavírání, změní nastavení a stisk opakuje. Chromium 145 ponechalo dialog poprvé otevřený a podruhé jej zavřelo. Příklad ověřuje dostupnost DOM funkce a zachovává tlačítko pro zavření; podporu novějšího atributu nelze předpokládat v každém prohlížeči.
Příklady
<!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>Výsledek
none-open=true; closerequest-open=false
Test posílá izolované stránce dvě skutečné klávesové události a ověřuje otevření po každé z nich.