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

CKTIS / CSS

:host() — seleccionar condicionalmente un host de Shadow DOM

La pseudoclase :host() selecciona un elemento host de Shadow DOM cuando coincide con el selector entre paréntesis. Se aplica en el contexto del árbol de sombra de ese host y permite que sus estilos dependan de una clase, un atributo u otra condición.

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

Sintaxis

:host(<compound-selector>) { /* declarations */ }

:host() es una pseudoclase funcional que se usa en la hoja de estilos de un árbol de sombra. Selecciona el host de ese árbol si coincide con el argumento. Fuera del contexto de un árbol de sombra, no coincide con nada. En cambio, :host no requiere ninguna condición adicional.

El argumento es un selector compuesto (<compound-selector>), como .active o .active[disabled]: sus condiciones se aplican al mismo elemento y no están separadas por combinadores. No proporciones directamente la lista .active, .pending ni el selector .wrapper .active. :host(.active) comprueba el host, no su antecesor ni su descendiente; .active:host no es equivalente.

La especificidad de :host() es (0,1,0) más la especificidad de su argumento. Por tanto, :host(.active) tiene una especificidad de (0,2,0), mientras que :host tiene una de (0,1,0). El ejemplo lee padding-left antes y después de quitar .active para comprobar el cambio en la coincidencia.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>:host() test</title>
<div id="host" class="active"></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  const root = host.attachShadow({ mode: 'open' });
  root.innerHTML = `
    <style>
      :host { display: block; padding-left: 0px; }
      :host(.active) { padding-left: 12px; }
    </style>
    <span>Shadow content</span>
  `;
  const before = getComputedStyle(host).paddingLeft;
  host.classList.remove('active');
  const after = getComputedStyle(host).paddingLeft;
  document.getElementById('result').textContent = `${before}\n${after}`;
</script>

Resultado

12px
0px

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