Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje