Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:state() — pseudoklasa własnego stanu

:state() wybiera elementy niestandardowe na podstawie ich własnych stanów. Argument jest identyfikatorem CSS, a wielkość liter ma znaczenie.

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

Składnia

:state( <ident> )

:state() to nazwa pseudoklasy funkcyjnej; zapis :state( <ident> ) wymaga jednego identyfikatora CSS, np. :state(ready). Nawiasy nie mogą być puste, a nazwa stanu nie jest tekstem w cudzysłowie.

Selektor dopasowuje element niestandardowy, którego zbiór stanów zawiera podaną nazwę. Porównanie rozróżnia wielkość liter: stan ready nie dopasowuje :state(READY). Szczegóły dopasowania określa język dokumentu, np. HTML.

W przykładzie JavaScript dodaje ready przez ElementInternals.states, a CSS wybiera element state-badge. Po uruchomieniu przykładu w Chromium konsola wyświetliła oczekiwany wynik. Sprawdź przykład w docelowej przeglądarce przed wdrożeniem.

Przykłady

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

Wynik

true
false

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła