Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori