WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

:state() — Pseudoklasse für benutzerdefinierte Zustände

:state() wählt benutzerdefinierte Elemente anhand ihrer benutzerdefinierten Zustände aus. Das Argument ist ein CSS-Bezeichner; beim Abgleich wird zwischen Groß- und Kleinschreibung unterschieden.

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

Syntax

:state( <ident> )

:state() bezeichnet eine funktionale Pseudoklasse. Die Syntax :state( <ident> ) erfordert genau einen CSS-Bezeichner, zum Beispiel :state(ready). Die Klammern dürfen nicht leer sein, und der Zustandsname ist keine Zeichenfolge in Anführungszeichen.

Der Selektor trifft auf ein benutzerdefiniertes Element zu, dessen Zustandsmenge diesen Namen enthält. Beim Vergleich wird zwischen Groß- und Kleinschreibung unterschieden: Der Zustand ready trifft nicht auf :state(READY) zu. Die genaue Abgleichsweise wird durch die Dokumentsprache, etwa HTML, festgelegt.

Im Beispiel fügt JavaScript über ElementInternals.states den Zustand ready hinzu, und CSS wählt das Element state-badge aus. Bei der Ausführung in Chromium lieferte das Beispiel die erwartete Konsolenausgabe. Überprüfe das Beispiel vor der Bereitstellung im Zielbrowser.

Beispiele

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

Ergebnis

true
false

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen