Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

dialog — nativní dialogové okno

Element `dialog` představuje dočasné okno pro dokončení úkolu nebo zobrazení informací. Metoda `show()` ho zobrazí nemodálně, zatímco `showModal()` zablokuje interakci se zbytkem dokumentu.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);

dialog je okno pro krátkou interakci s aplikací, nikoli náhrada nabídky ani bublinové nápovědy (tooltipu). Je nutná počáteční i koncová značka. Bez open se ve výchozím stavu nezobrazuje; samotné open nevytvoří modální dialogové okno.

show() zobrazí nemodální dialogové okno. showModal() ho umístí do nejvyšší vrstvy; zbytek dokumentu bude neaktivní (inert). Element musí být připojený k dokumentu. Volání showModal() u dialogového okna, které je již otevřené nemodálně, vyvolá InvalidStateError.

Zajistěte smysluplný název, například pomocí aria-labelledby, a viditelné tlačítko pro zavření. Počáteční fokus nastavte pomocí autofocus na vhodném ovládacím prvku. Na dialog nenastavujte tabindex.

close(result) zavře dialogové okno, uloží zadaný řetězec do returnValue a vyvolá událost close. requestClose(result) nejprve vyvolá zrušitelnou událost cancel; preventDefault() může zavření zastavit. Neodstraňujte open ručně, protože tím obejdete správný průběh zavírání. closedby řídí automatické zavírání: any povoluje také kliknutí mimo okno, closerequest povoluje požadavky na zavření a none nepovoluje ani jedno. Bez tohoto atributu modální dialogová okna požadavky na zavření zpracovávají, nemodální nikoli.

Pří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ýsledek

Result: confirmed

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje