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

CKTIS / CSS

:host — aplicar estilos a un host de Shadow DOM

La pseudoclase :host permite que una hoja de estilo dentro del Shadow DOM seleccione su elemento host. Fuera del contexto de un árbol de sombra, no coincide con ningún elemento.

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

Sintaxis

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

:host selecciona el host de un árbol de sombra: el elemento al que está adjunta la raíz de sombra. Coloca la regla en la hoja de estilo de ese árbol; en una hoja de estilo del documento, :host no coincide con nada.

El selector apunta al host, no a sus elementos internos. Su especificidad es (0,1,0). La variante :host(.active) también comprueba la clase del host y tiene una especificidad de (0,2,0); su argumento es un selector compuesto sin combinadores, no una lista de selectores.

En el ejemplo, la hoja de estilo dentro de la raíz de sombra establece display y padding en host. El resultado lee los estilos calculados del host, no los del elemento span.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>:host example</title>
<div id="host"></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  const root = host.attachShadow({ mode: 'open' });
  root.innerHTML = `
    <style>
      :host { display: block; padding: 8px; }
    </style>
    <span>Shadow content</span>
  `;
  const style = getComputedStyle(host);
  document.getElementById('result').textContent =
    `display: ${style.display}\npadding: ${style.paddingTop}`;
</script>

Resultado

display: block
padding: 8px

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