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.