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

CKTIS / CSS

:modal — psevdorazred modalnega stanja

Psevdorazred :modal izbere elemente v modalnem stanju, ne zgolj vidnih ali odprtih elementov. Z njim lahko oblikuješ na primer pogovorno okno, odprto z showModal(), in ga razlikuješ od okna, odprtega z show().

Različica: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintaksa

:modal

:modal je psevdorazred brez argumentov, ki se ujema z elementom v stanju, ki izključuje interakcijo z elementi zunaj njega. Izbirnik dialog:modal omeji ujemanje na elemente dialog. Pravilo CSS se na to stanje samo odzove — modalnosti ne vklopi.

V HTML se ujema z elementi dialog, katerih notranje modalno stanje je resnično, in z elementi, pri katerih je nastavljena zastavica celozaslonskega načina. showModal() odpre pogovorno okno modalno; show() ga odpre nemodalno. Sam atribut open zato še ne pomeni, da se element ujema z :modal: dialog[open] izbere tako odprta modalna kot odprta nemodalna pogovorna okna.

:modal ne obravnavaj kot sopomenke za aktivno okno ali kot izbirnika, namenjenega izključno pogovornim oknom. Več elementov se lahko hkrati ujema z :modal, čeprav je aktiven in lahko prejema vnose samo eden. Tudi ujemanje s celozaslonskimi elementi je dodaten razlog za uporabo dialog:modal, kadar naj slog velja samo za pogovorna okna.

Primer zabeleži matches(':modal') za zaprto pogovorno okno, po show() in po kliku na gumb, ki pokliče showModal(). Pričakovane vrednosti so po vrsti false, false in true; modalno pogovorno okno dobi zelen rob. Primer je treba lokalno preveriti v ciljnem brskalniku.

Primeri

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>:modal test</title>
<style>
  dialog { border: 3px solid gray; }
  dialog:modal { border-color: green; }
</style>
<button id="open" type="button">Open modal</button>
<dialog id="panel" aria-label="Modal test">
  <p>Modal dialog</p>
  <form method="dialog"><button>Close</button></form>
</dialog>
<pre id="result"></pre>
<script>
  const panel = document.querySelector('#panel');
  const result = document.querySelector('#result');
  const lines = [];
  function record(label) {
    lines.push(`${label}: ${panel.matches(':modal')}`);
    result.textContent = lines.join('\n');
  }
  record('closed');
  panel.show();
  record('show()');
  panel.close();
  document.querySelector('#open').addEventListener('click', () => {
    panel.showModal();
    record('showModal()');
  }, { once: true });
</script>
</html>

Rezultat

closed: false
show(): false
showModal(): true

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

Viri