Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti