CKTIS / HTML
dialog — een native dialoogvenster
Het element `dialog` stelt een tijdelijk venster voor om een taak uit te voeren of informatie te tonen. De methode `show()` toont het niet-modaal, terwijl `showModal()` interactie met de rest van het document blokkeert.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);dialog is een venster voor een korte interactie met de applicatie, geen vervanging voor een menu of tooltip. Zowel de begin- als eindtag is vereist. Zonder open wordt het standaard niet weergegeven; open alleen maakt het dialoogvenster niet modaal.
show() toont een niet-modaal dialoogvenster. showModal() plaatst het in de bovenste laag; de rest van het document wordt inactief (inert). Het element moet met het document verbonden zijn. showModal() aanroepen voor een dialoogvenster dat al niet-modaal geopend is, veroorzaakt InvalidStateError.
Geef het een betekenisvolle naam, bijvoorbeeld via aria-labelledby, en een zichtbare sluitknop. Kies de initiële focus met autofocus op een geschikt bedieningselement. Stel geen tabindex in op dialog.
close(result) sluit het dialoogvenster, slaat de opgegeven tekenreeks op in returnValue en veroorzaakt een close-gebeurtenis. requestClose(result) activeert eerst de annuleerbare gebeurtenis cancel; preventDefault() kan het sluiten tegenhouden. Verwijder open niet handmatig, want daarmee omzeil je de juiste sluitingscyclus. closedby bepaalt automatisch sluiten: any staat ook klikken buiten het venster toe, closerequest staat sluitverzoeken toe en none staat geen van beide toe. Zonder dit attribuut verwerken modale dialoogvensters sluitverzoeken en niet-modale niet.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Dialog example</title>
<button id="launch" type="button">Open</button>
<dialog id="box" aria-labelledby="heading">
<h2 id="heading">Confirmation</h2>
<p>Close this dialog to continue.</p>
<button id="finish" type="button" autofocus>OK</button>
</dialog>
<p id="status" role="status">Ready</p>
<script>
const box = document.getElementById('box');
const status = document.getElementById('status');
document.getElementById('launch').addEventListener('click', () => {
box.returnValue = '';
box.showModal();
});
document.getElementById('finish').addEventListener('click', () => {
box.close('confirmed');
});
box.addEventListener('close', () => {
status.textContent = box.returnValue === 'confirmed'
? 'Result: confirmed'
: 'Result: dismissed';
});
</script>
</html>Resultaat
Result: confirmed
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.