Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

:state() — pseudoclasse de estado personalizado

:state() seleciona elementos personalizados com base nos respetivos estados personalizados. O argumento é um identificador CSS e a correspondência distingue maiúsculas de minúsculas.

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

Sintaxe

:state( <ident> )

:state() é o nome de uma pseudoclasse funcional. A sintaxe :state( <ident> ) exige um único identificador CSS, como :state(ready). Os parênteses não podem estar vazios e o nome do estado não é uma cadeia entre aspas.

O seletor corresponde a um elemento personalizado cujo conjunto de estados contém esse nome. A comparação distingue maiúsculas de minúsculas: o estado ready não corresponde a :state(READY). A linguagem do documento, como HTML, define o comportamento exato da correspondência.

No exemplo, JavaScript adiciona ready através de ElementInternals.states, e CSS seleciona o elemento state-badge. Ao executar o exemplo no Chromium, a consola apresentou o resultado esperado. Verifique o exemplo no navegador de destino antes da implementação.

Exemplos

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

Resultado

true
false

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.

Fontes