Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła