CKTIS / CSS
:modal — pseudoclasse dello stato modale
La pseudoclasse :modal seleziona gli elementi nello stato modale, non semplicemente quelli visibili o aperti. Permette, per esempio, di applicare uno stile a un dialogo aperto con showModal() distinguendolo da uno aperto con show().
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
:modal:modal è una pseudoclasse senza argomenti che corrisponde a un elemento in uno stato che esclude l’interazione con gli elementi al suo esterno. Il selettore dialog:modal limita la corrispondenza agli elementi dialog. Una regola CSS reagisce soltanto a questo stato: non attiva la modalità modale.
In HTML, la pseudoclasse corrisponde agli elementi dialog il cui stato modale interno è vero e agli elementi con il flag di schermo intero impostato. showModal() apre un dialogo in modalità modale; show() lo apre in modalità non modale. Il solo attributo open non implica quindi una corrispondenza con :modal: dialog[open] seleziona sia i dialoghi modali aperti sia quelli non modali aperti.
Non considerare :modal un sinonimo di finestra attiva né un selettore riservato esclusivamente ai dialoghi. Più elementi possono corrispondere contemporaneamente a :modal, anche se solo uno è attivo e può ricevere input. La corrispondenza anche con gli elementi a schermo intero è un altro motivo per usare dialog:modal quando lo stile deve riguardare solo i dialoghi.
L’esempio registra matches(':modal') per un dialogo chiuso, dopo show() e dopo aver fatto clic sul pulsante che chiama showModal(). I valori attesi sono, nell’ordine, false, false e true; il dialogo modale riceve un bordo verde. È necessario verificare localmente l’esempio nel browser di destinazione.
Esempi
<!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>Risultato
closed: false show(): false showModal(): true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.