CKTIS / HTML
closedby: dozwolone sposoby zamykania dialogu
Oddziel automatyczne zamykanie od jawnych przycisków aplikacji.
Wersja: HTML Living Standard
Składnia
<dialog closedby="none">...</dialog>Na dialogu closedby określa dozwolone automatyczne sposoby zamknięcia. any obejmuje kliknięcia poza dialogiem i żądania zamknięcia; closerequest obejmuje żądania takie jak Escape, lecz nie zamykanie kliknięciem poza oknem; none wyłącza automatyczne zamykanie przez użytkownika. Brak lub niepoprawna wartość oznacza stan automatyczny: dialog modalny dopuszcza żądania zamknięcia, a niemodalny nie zamyka się automatycznie.
Nie blokuje to celowych działań aplikacji. Nadal dostępne są close() i requestClose(); druga metoda wywołuje anulowalne zdarzenie anulowania i ignoruje ograniczenie closedby. Jeśli wyłączasz automatyczne zamykanie, zawsze zapewnij dostępny, jawny sposób wyjścia. Nie usuwaj ręcznie atrybutu otwarcia zamiast użycia właściwych metod zamykania.
Scenariusz otwiera dialog modalny, naciska Escape przy wyłączonym zamykaniu, zmienia ustawienie i ponownie naciska Escape. Chromium 145 zachował otwarcie przy pierwszym żądaniu, a zamknął dialog przy drugim. Przykład sprawdza dostępność funkcji DOM i zachowuje przycisk zamknięcia; nie wolno zakładać obsługi tego nowszego atrybutu w każdej przeglądarce.
Przykłady
<!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>Wynik
none-open=true; closerequest-open=false
Test wysyła dwa rzeczywiste zdarzenia klawiatury do odizolowanej strony i sprawdza stan otwarcia po każdym.