KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

closedby: bepalen hoe een dialoog mag sluiten

Scheid automatisch sluiten van expliciete bediening door de toepassing.

Versie: HTML Living Standard

Syntax

<dialog closedby="none">...</dialog>

Op een dialoog kiest closedby de toegestane automatische sluitacties. any omvat buitenklikken en sluitverzoeken; closerequest omvat verzoeken zoals Escape, maar niet sluiten door buitenklikken; none schakelt automatisch sluiten door gebruikersacties uit. Ontbrekende of ongeldige waarden gebruiken de automatische toestand: een modale dialoog staat sluitverzoeken toe, terwijl een niet-modale dialoog niet automatisch sluit.

Dit schakelt bewuste toepassingsacties niet uit. Zowel close() als requestClose() blijft beschikbaar; de laatste activeert de annuleerbare annuleringsgebeurtenis en negeert de closedby-beperking. Bied altijd een toegankelijke, expliciete uitgang als automatisch sluiten is uitgeschakeld. Verwijder niet handmatig het open-attribuut als vervanging voor de juiste sluitmethoden.

De testopstelling opent een modale dialoog, drukt op Escape terwijl sluiten is uitgeschakeld, verandert vervolgens de instelling en drukt nogmaals op Escape. Chromium 145 liet de dialoog eerst open en sloot hem bij het tweede verzoek. Het voorbeeld controleert de DOM-ondersteuning en behoudt een expliciete sluitknop; neem niet aan dat dit nieuwere attribuut in iedere browser werkt.

Voorbeelden

<!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>

Resultaat

none-open=true; closerequest-open=false

De test stuurt twee echte toetsenbordgebeurtenissen naar de geïsoleerde pagina en controleert na elke gebeurtenis de open toestand.

Bronnen