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

CKTIS / CSS

:host — aplicar estilos a um anfitrião Shadow DOM

A pseudoclasse :host permite que uma folha de estilos dentro do Shadow DOM selecione o respetivo elemento anfitrião. Fora do contexto de uma árvore de sombra, não corresponde a nenhum elemento.

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

Sintaxe

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

:host seleciona o anfitrião de uma árvore de sombra: o elemento ao qual a raiz de sombra está anexada. Coloca a regra na folha de estilos dessa árvore; numa folha de estilos do documento, :host não corresponde a nada.

O seletor visa o anfitrião, não os seus elementos internos. A sua especificidade é (0,1,0). A variante :host(.active) também verifica a classe do anfitrião e tem especificidade (0,2,0); o argumento é um seletor composto sem combinadores, não uma lista de seletores.

No exemplo, a folha de estilos dentro da raiz de sombra define display e padding para host. O resultado lê os estilos calculados do anfitrião, e não os do elemento span.

Exemplos

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

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