Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

:modal — pseudoclasse do estado modal

A pseudoclasse :modal seleciona elementos no estado modal, e não simplesmente elementos visíveis ou abertos. Permite, por exemplo, aplicar estilos a uma caixa de diálogo aberta com showModal() e distingui-la de uma aberta com show().

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

Sintaxe

:modal

:modal é uma pseudoclasse sem argumentos que corresponde a um elemento num estado que exclui a interação com elementos fora dele. O seletor dialog:modal restringe a correspondência aos elementos dialog. Uma regra CSS apenas reage a este estado — não ativa a modalidade.

Em HTML, a correspondência inclui elementos dialog cujo estado modal interno é verdadeiro e elementos com a indicação de ecrã inteiro definida. showModal() abre uma caixa de diálogo em modo modal; show() abre-a em modo não modal. Por isso, o atributo open, por si só, não implica uma correspondência com :modal: dialog[open] seleciona tanto caixas de diálogo modais abertas como caixas de diálogo não modais abertas.

Não trates :modal como sinónimo de janela ativa nem como um seletor exclusivo para caixas de diálogo. Vários elementos podem corresponder a :modal ao mesmo tempo, embora apenas um esteja ativo e possa receber dados de entrada. O facto de também corresponder a elementos em ecrã inteiro é outro motivo para usar dialog:modal quando um estilo se deve aplicar apenas a caixas de diálogo.

O exemplo regista matches(':modal') para uma caixa de diálogo fechada, depois de show() e depois de clicar no botão que chama showModal(). Os valores esperados são, respetivamente, false, false e true; a caixa de diálogo modal fica com uma borda verde. É necessário verificar o exemplo localmente no navegador de destino.

Exemplos

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes