Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

:modal — pseudoclase de estado modal

La pseudoclase :modal selecciona elementos en estado modal, no simplemente elementos visibles o abiertos. Permite aplicar estilos, por ejemplo, a un diálogo abierto con showModal() y distinguirlo de uno abierto con show().

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

Sintaxis

:modal

:modal es una pseudoclase sin argumentos que coincide con un elemento en un estado que excluye la interacción con los elementos que están fuera de él. El selector dialog:modal limita la coincidencia a los elementos dialog. Una regla CSS solo responde a este estado: no activa la modalidad.

En HTML, la coincidencia incluye los elementos dialog cuyo estado modal interno es verdadero y los elementos que tienen activada la marca de pantalla completa. showModal() abre un diálogo de forma modal; show() lo abre de forma no modal. Por tanto, el atributo open por sí solo no implica que haya una coincidencia con :modal: dialog[open] selecciona tanto los diálogos modales abiertos como los no modales abiertos.

No consideres :modal un sinónimo de ventana activa ni un selector exclusivo para diálogos. Varios elementos pueden coincidir con :modal a la vez, aunque solo uno esté activo y pueda recibir entradas. Que también coincida con elementos a pantalla completa es otro motivo para usar dialog:modal cuando el estilo deba aplicarse solo a los diálogos.

El ejemplo registra matches(':modal') para un diálogo cerrado, después de show() y después de hacer clic en el botón que llama a showModal(). Los valores esperados son false, false y true, respectivamente; el diálogo modal obtiene un borde verde. Es necesario verificar el ejemplo localmente en el navegador de destino.

Ejemplos

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

Resultado

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes