CKTIS / HTML
closedby: bestimmen, wie sich ein Dialog schließen lässt
Trenne automatisches Schließen von ausdrücklich angebotenen Bedienelementen der Anwendung.
Version: HTML Living Standard
Syntax
<dialog closedby="none">...</dialog>Auf einem Dialog bestimmt closedby, welche automatischen Schließaktionen erlaubt sind. any umfasst Klicks außerhalb und Schließanforderungen; closerequest umfasst Anforderungen wie Escape, jedoch kein Schließen durch Außenklick; none verhindert automatisches Schließen durch Benutzeraktionen. Fehlende oder ungültige Werte verwenden den automatischen Zustand: Ein modaler Dialog erlaubt Schließanforderungen, ein nichtmodaler Dialog schließt sich nicht automatisch.
Dies verhindert keine bewussten Anwendungsaktionen. Sowohl close() als auch requestClose() bleiben verfügbar; Letzteres löst das abbrechbare Abbruchereignis aus und ignoriert die closedby-Beschränkung. Biete immer einen barrierefrei bedienbaren ausdrücklichen Ausgang an, wenn automatisches Schließen deaktiviert ist. Entferne das open-Attribut nicht manuell als Ersatz für die vorgesehenen Schließmethoden.
Die Testkonfiguration öffnet einen modalen Dialog, drückt Escape bei deaktiviertem Schließen, ändert dann die Einstellung und drückt erneut Escape. Chromium 145 ließ den Dialog zunächst offen und schloss ihn bei der zweiten Anforderung. Das Beispiel prüft die DOM-Unterstützung und behält einen ausdrücklichen Schließen-Button bei; bei diesem neueren Attribut darfst du nicht von universeller Browserunterstützung ausgehen.
Beispiele
<!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>Ergebnis
none-open=true; closerequest-open=false
Der Test sendet zwei tatsächliche Tastaturereignisse an die isolierte Seite und prüft nach jedem den Öffnungszustand.