CKTIS / HTML
dialog — izvorni dijaloški prozor
Element `dialog` predstavlja privremeni prozor za izvršavanje zadatka ili prikaz informacija. Metoda `show()` prikazuje ga nemodalno, dok `showModal()` blokira interakciju s ostatkom dokumenta.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);dialog je prozor za kratku interakciju s aplikacijom, a ne zamjena za izbornik ili oblačić s opisom (tooltip). Potrebne su i početna i završna oznaka. Bez open ne prikazuje se prema zadanim postavkama; sam open ne stvara modalni dijaloški prozor.
show() prikazuje nemodalni dijaloški prozor. showModal() smješta ga u najviši sloj; ostatak dokumenta postaje neaktivan (inert). Element mora biti povezan s dokumentom. Pozivanje metode showModal() na dijaloškom prozoru koji je već otvoren nemodalno izaziva InvalidStateError.
Dodijelite mu smislen naziv, primjerice putem aria-labelledby, i vidljiv gumb za zatvaranje. Početni fokus odaberite pomoću autofocus na prikladnoj kontroli. Nemojte postavljati tabindex na dialog.
close(result) zatvara dijaloški prozor, sprema zadani niz u returnValue i izaziva događaj close. requestClose(result) najprije pokreće događaj cancel koji se može otkazati; preventDefault() može zaustaviti zatvaranje. Nemojte ručno uklanjati open jer time zaobilazite ispravan tijek zatvaranja. closedby upravlja automatskim zatvaranjem: any dopušta i klikove izvan prozora, closerequest dopušta zahtjeve za zatvaranje, a none ne dopušta ni jedno ni drugo. Bez tog atributa modalni dijaloški prozori obrađuju zahtjeve za zatvaranje, a nemodalni ne.
Primjeri
<!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>Rezultat
Result: confirmed
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.