CKTIS / HTML
closedby: povolené zatváranie dialógu
Oddeľte automatické zatvorenie od výslovných ovládacích prvkov aplikácie.
Verzia: HTML Living Standard
Syntax
<dialog closedby="none">...</dialog>Na dialógu closedby vyberá povolené automatické spôsoby zatvárania. any zahŕňa kliknutie mimo aj požiadavky na zatvorenie; closerequest zahŕňa požiadavky ako Escape, ale nie kliknutie mimo okna; none automatické zatváranie používateľským gestom vypína. Chýbajúca či neplatná hodnota dáva automatický stav: modálny dialóg povoľuje požiadavky na zatvorenie, nemodálny sa automaticky nezatvára.
Nezakazuje to zámerné akcie aplikácie. Dostupné zostávajú close() aj requestClose(); druhá metóda vyvolá zrušiteľnú udalosť zrušenia a ignoruje obmedzenie closedby. Ak automatické zatváranie vypnete, vždy poskytnite prístupný výslovný spôsob odchodu. Ručné odstránenie atribútu otvorenia nenahrádza správne zatváracie metódy.
Scenár otvorí modálny dialóg, stlačí Escape pri zakázanom zatváraní, zmení nastavenie a stlačenie opakuje. Chromium 145 pri prvej požiadavke ponechalo dialóg otvorený a pri druhej ho zatvorilo. Príklad kontroluje dostupnosť DOM funkcie a zachováva tlačidlo zatvorenia; novší atribút nemožno pokladať za podporovaný všade.
Prí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ýsledok
none-open=true; closerequest-open=false
Test odošle izolovanej stránke dve skutočné klávesové udalosti a po každej overí otvorený stav.