Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

:state() — pseudoclase de estado personalizado

:state() selecciona elementos personalizados según sus estados personalizados. Su argumento es un identificador CSS y la coincidencia distingue entre mayúsculas y minúsculas.

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

Sintaxis

:state( <ident> )

:state() es el nombre de una pseudoclase funcional. La sintaxis :state( <ident> ) requiere un único identificador CSS, como :state(ready). Los paréntesis no pueden estar vacíos y el nombre del estado no es una cadena entre comillas.

El selector coincide con un elemento personalizado cuyo conjunto de estados contiene ese nombre. La comparación distingue entre mayúsculas y minúsculas: el estado ready no coincide con :state(READY). El lenguaje del documento, como HTML, define el comportamiento exacto de la coincidencia.

En el ejemplo, JavaScript añade ready mediante ElementInternals.states, y CSS selecciona el elemento state-badge. Al ejecutar el ejemplo en Chromium, la consola mostró el resultado esperado. Comprueba el ejemplo en el navegador de destino antes del despliegue.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes