Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

:modal — pseudotřída modálního stavu

Pseudotřída :modal vybírá prvky v modálním stavu, nikoli pouze viditelné nebo otevřené prvky. Umožňuje například stylovat dialog otevřený pomocí showModal() a odlišit ho od dialogu otevřeného pomocí show().

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

Syntaxe

:modal

:modal je pseudotřída bez argumentů, která odpovídá prvku ve stavu vylučujícím interakci s prvky mimo něj. Selektor dialog:modal omezuje výběr na prvky dialog. Pravidlo CSS na tento stav pouze reaguje — samo modalitu nezapíná.

V HTML odpovídají prvky dialog, jejichž interní modální stav je pravdivý, a také prvky s nastaveným příznakem celé obrazovky. showModal() otevře dialog modálně; show() ho otevře nemodálně. Samotný atribut open tedy neznamená, že prvek odpovídá :modal: dialog[open] vybírá otevřené modální i otevřené nemodální dialogy.

Nepovažuj :modal za synonymum aktivního okna ani za selektor určený výhradně pro dialogy. Více prvků může současně odpovídat :modal, přestože aktivní a schopný přijímat vstup je pouze jeden. To, že se vybírají i prvky na celé obrazovce, je dalším důvodem použít dialog:modal, když se má styl použít pouze pro dialogy.

Příklad zaznamenává matches(':modal') pro zavřený dialog, po show() a po kliknutí na tlačítko, které volá showModal(). Očekávané hodnoty jsou postupně false, false a true; modální dialog dostane zelený okraj. Příklad je třeba místně ověřit v cílovém prohlížeči.

Příklady

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

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje