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.