CKTIS / CSS
:modal — Pseudoklasse für den Modalzustand
Die Pseudoklasse :modal wählt Elemente im Modalzustand aus, nicht einfach sichtbare oder geöffnete Elemente. Sie kann beispielsweise einen mit showModal() geöffneten Dialog formatieren und ihn von einem mit show() geöffneten Dialog unterscheiden.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
:modal:modal ist eine Pseudoklasse ohne Argumente. Sie trifft auf ein Element in einem Zustand zu, der Interaktionen mit Elementen außerhalb davon ausschließt. Der Selektor dialog:modal beschränkt die Auswahl auf dialog-Elemente. Eine CSS-Regel reagiert lediglich auf diesen Zustand – sie stellt den Modalzustand nicht selbst her.
In HTML trifft die Pseudoklasse auf dialog-Elemente zu, deren interner Modalzustand aktiv ist, sowie auf Elemente, deren Vollbildkennzeichen gesetzt ist. showModal() öffnet einen Dialog modal; show() öffnet ihn nicht modal. Das Attribut open allein bedeutet daher nicht, dass :modal zutrifft: dialog[open] wählt sowohl geöffnete modale als auch geöffnete nicht modale Dialoge aus.
Behandle :modal nicht als Synonym für das aktive Fenster oder als Selektor ausschließlich für Dialoge. Mehrere Elemente können gleichzeitig auf :modal zutreffen, obwohl nur eines davon aktiv ist und Eingaben empfangen kann. Dass auch Vollbildelemente erfasst werden, ist ein weiterer Grund, dialog:modal zu verwenden, wenn ein Stil nur für Dialoge gelten soll.
Das Beispiel protokolliert matches(':modal') für einen geschlossenen Dialog, nach show() und nach dem Klick auf die Schaltfläche, die showModal() aufruft. Die erwarteten Werte sind der Reihe nach false, false und true; der modale Dialog erhält einen grünen Rahmen. Das Beispiel muss im Zielbrowser lokal überprüft werden.
Beispiele
<!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>Ergebnis
closed: false show(): false showModal(): true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.