CKTIS / HTML
closedby: dopušteni načini zatvaranja dijaloga
Odvojite automatsko zatvaranje od izričitih kontrola aplikacije.
Verzija: HTML Living Standard
Sintaksa
<dialog closedby="none">...</dialog>Na dijalogu closedby odabire dopuštena automatska zatvaranja. any uključuje klikove izvan i zahtjeve za zatvaranje; closerequest uključuje zahtjeve poput Escape, ali ne zatvaranje klikom izvan; none isključuje automatsko korisničko zatvaranje. Nedostajuće ili nevaljane vrijednosti daju automatsko stanje: modalni dijalog dopušta zahtjeve za zatvaranje, nemodalni se ne zatvara automatski.
To ne zabranjuje namjerne radnje aplikacije. Dostupni ostaju close() i requestClose(); druga metoda pokreće otkazivi događaj otkazivanja i zanemaruje ograničenje closedby. Ako isključite automatsko zatvaranje, uvijek osigurajte pristupačan izričit izlaz. Ručno uklanjanje atributa otvorenosti nije zamjena za pravilne metode zatvaranja.
Scenarij otvara modalni dijalog, pritišće Escape dok je zatvaranje zabranjeno, mijenja postavku i ponavlja pritisak. Chromium 145 prvi je put ostavio dijalog otvoren, a drugi ga zatvorio. Primjer provjerava DOM mogućnost i zadržava gumb za zatvaranje; ne pretpostavljajte podršku novijem atributu u svakom pregledniku.
Primjeri
<!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>Rezultat
none-open=true; closerequest-open=false
Test izoliranoj stranici šalje dva prava tipkovnička događaja i provjerava otvorenost nakon svakoga.