Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

:state() — pseudo-classe d’état personnalisé

:state() sélectionne les éléments personnalisés en fonction de leurs états personnalisés. Son argument est un identifiant CSS et la comparaison respecte la casse.

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

Syntaxe

:state( <ident> )

:state() désigne une pseudo-classe fonctionnelle. La syntaxe :state( <ident> ) exige un seul identifiant CSS, par exemple :state(ready). Les parenthèses ne peuvent pas être vides, et le nom de l’état n’est pas une chaîne entre guillemets.

Le sélecteur correspond à un élément personnalisé dont l’ensemble d’états contient ce nom. La comparaison respecte la casse : l’état ready ne correspond pas à :state(READY). Le langage du document, tel que HTML, définit le comportement exact de la correspondance.

Dans l’exemple, JavaScript ajoute ready via ElementInternals.states, et CSS sélectionne l’élément state-badge. Lors de l’exécution de l’exemple dans Chromium, la console a affiché le résultat attendu. Vérifiez l’exemple dans le navigateur cible avant le déploiement.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Custom state</title>
<style>
  state-badge { color: black; }
  state-badge:state(ready) { color: green; }
</style>
<state-badge>Ready</state-badge>
<script>
  customElements.define('state-badge', class extends HTMLElement {
    constructor() {
      super();
      this.attachInternals().states.add('ready');
    }
  });
  const badge = document.querySelector('state-badge');
  console.log(badge.matches(':state(ready)'));
  console.log(badge.matches(':state(READY)'));
</script>

Résultat

true
false

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.

Sources