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.