CKTIS / HTML
dialog — natívne dialógové okno
Element `dialog` predstavuje dočasné okno na dokončenie úlohy alebo zobrazenie informácií. Metóda `show()` ho zobrazí nemodálne, zatiaľ čo `showModal()` zablokuje interakciu so zvyškom dokumentu.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);dialog je okno na krátku interakciu s aplikáciou, nie náhrada ponuky ani bublinového pomocníka (tooltipu). Vyžaduje sa začiatočná aj koncová značka. Bez open sa predvolene nezobrazuje; samotné open nevytvorí modálne dialógové okno.
show() zobrazí nemodálne dialógové okno. showModal() ho umiestni do najvyššej vrstvy; zvyšok dokumentu bude neaktívny (inert). Element musí byť pripojený k dokumentu. Volanie showModal() na dialógovom okne, ktoré je už otvorené nemodálne, vyvolá InvalidStateError.
Zabezpečte zmysluplný názov, napríklad pomocou aria-labelledby, a viditeľné tlačidlo na zatvorenie. Počiatočný fokus nastavte pomocou autofocus na vhodnom ovládacom prvku. Na dialog nenastavujte tabindex.
close(result) zatvorí dialógové okno, uloží zadaný reťazec do returnValue a vyvolá udalosť close. requestClose(result) najprv vyvolá zrušiteľnú udalosť cancel; preventDefault() môže zatvorenie zastaviť. Neodstraňujte open ručne, pretože tým obídete správny postup zatvárania. closedby riadi automatické zatváranie: any povoľuje aj kliknutia mimo okna, closerequest povoľuje požiadavky na zatvorenie a none nepovoľuje ani jedno. Bez tohto atribútu modálne dialógové okná spracúvajú požiadavky na zatvorenie, nemodálne nie.
Príklady
<!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>Výsledok
Result: confirmed
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.