CKTIS / CSS
:modal — pseudo-classe d’état modal
La pseudo-classe :modal sélectionne les éléments en état modal, et pas simplement ceux qui sont visibles ou ouverts. Elle permet notamment de styliser un dialogue ouvert avec showModal() en le distinguant d’un dialogue ouvert avec show().
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
:modal:modal est une pseudo-classe sans argument qui correspond à un élément dans un état excluant toute interaction avec les éléments situés en dehors de celui-ci. Le sélecteur dialog:modal limite la sélection aux éléments dialog. Une règle CSS réagit uniquement à cet état : elle ne rend pas l’élément modal.
En HTML, la pseudo-classe correspond aux éléments dialog dont l’état modal interne est vrai, ainsi qu’aux éléments dont l’indicateur de plein écran est activé. showModal() ouvre un dialogue de manière modale ; show() l’ouvre de manière non modale. L’attribut open ne suffit donc pas à faire correspondre :modal : dialog[open] sélectionne les dialogues ouverts, qu’ils soient modaux ou non.
Ne considère pas :modal comme un synonyme de fenêtre active ni comme un sélecteur réservé aux dialogues. Plusieurs éléments peuvent correspondre simultanément à :modal, même si un seul est actif et peut recevoir des entrées. Le fait que les éléments en plein écran soient également sélectionnés est une autre raison d’utiliser dialog:modal lorsque le style ne doit s’appliquer qu’aux dialogues.
L’exemple consigne le résultat de matches(':modal') pour un dialogue fermé, après show() et après le clic sur le bouton qui appelle showModal(). Les valeurs attendues sont respectivement false, false et true ; le dialogue modal reçoit une bordure verte. L’exemple doit être vérifié localement dans le navigateur cible.
Exemples
<!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>Résultat
closed: false show(): false showModal(): true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.