Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

dialog — izvorno pogovorno okno

Element `dialog` predstavlja začasno okno za izvedbo opravila ali prikaz informacij. Metoda `show()` ga prikaže nemodalno, medtem ko `showModal()` blokira interakcijo s preostalim dokumentom.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

dialog je okno za kratko interakcijo z aplikacijo, ne pa nadomestilo za meni ali namig. Potrebni sta začetna in končna oznaka. Brez open privzeto ni prikazano; samo open ne ustvari modalnega pogovornega okna.

show() prikaže nemodalno pogovorno okno. showModal() ga postavi v najvišjo plast; preostali dokument postane neaktiven (inert). Element mora biti povezan z dokumentom. Če showModal() pokličete za pogovorno okno, ki je že odprto nemodalno, se sproži InvalidStateError.

Zagotovite pomensko ustrezno ime, na primer z aria-labelledby, in viden gumb za zapiranje. Začetni fokus izberite z autofocus na ustreznem kontrolniku. Na dialog ne nastavite tabindex.

close(result) zapre pogovorno okno, shrani podani niz v returnValue in sproži dogodek close. requestClose(result) najprej sproži preklicni dogodek cancel; preventDefault() lahko prepreči zaprtje. Atributa open ne odstranite ročno, saj s tem zaobidete pravilen potek zapiranja. closedby določa samodejno zapiranje: any dovoljuje tudi klike zunaj okna, closerequest dovoljuje zahteve za zaprtje, none pa ne dovoljuje nobenega od teh načinov. Brez tega atributa modalna pogovorna okna obravnavajo zahteve za zaprtje, nemodalna pa ne.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri