CKTIS / CSS
:modal — pseudoklasa stanu modalnego
Pseudoklasa :modal wybiera elementy w stanie modalnym, a nie po prostu widoczne lub otwarte. Pozwala stylować między innymi dialog otwarty przez showModal(), odróżniając go od dialogu otwartego przez show().
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
:modal:modal to pseudoklasa bez argumentów, która dopasowuje element w stanie wykluczającym interakcję z elementami poza nim. Selektor dialog:modal ogranicza dopasowanie do elementów dialog. Reguła CSS jedynie reaguje na ten stan — nie włącza modalności.
W HTML dopasowanie obejmuje elementy dialog, których wewnętrzny stan modalności jest prawdziwy, oraz elementy z ustawioną flagą pełnego ekranu. showModal() otwiera dialog modalnie; show() otwiera go niemodalnie. Sam atrybut open nie oznacza więc dopasowania do :modal: dialog[open] wybiera zarówno otwarte dialogi modalne, jak i niemodalne.
Nie traktuj :modal jako synonimu aktywnego okna ani wyłącznie selektora dialogów. Kilka elementów może jednocześnie pasować do :modal, choć tylko jeden z nich jest aktywny i może odbierać dane wejściowe. Dopasowanie elementów pełnoekranowych jest dodatkowym powodem, by używać dialog:modal, gdy styl ma dotyczyć tylko dialogów.
Przykład zapisuje wyniki matches(':modal') dla zamkniętego dialogu, po show() i po kliknięciu przycisku wywołującego showModal(). Oczekiwane wartości to kolejno false, false i true; modalny dialog otrzymuje zielone obramowanie. Przykład wymaga lokalnej weryfikacji w docelowej przeglądarce.
Przykłady
<!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>Wynik
closed: false show(): false showModal(): true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.