CKTIS / CSS
:host() — selecionar condicionalmente um anfitrião Shadow DOM
A pseudoclasse :host() seleciona um elemento anfitrião Shadow DOM quando este corresponde ao seletor entre parênteses. É aplicada no contexto da árvore sombra desse anfitrião e permite que os estilos do anfitrião dependam de uma classe, de um atributo ou de outra condição.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
:host(<compound-selector>) { /* declarations */ }:host() é uma pseudoclasse funcional usada na folha de estilos de uma árvore sombra. Seleciona o anfitrião dessa árvore se este corresponder ao argumento. Fora do contexto de uma árvore sombra, não corresponde a nada. Em contrapartida, :host não requer uma condição adicional.
O argumento é um seletor composto (<compound-selector>), como .active ou .active[disabled]: as condições dizem respeito ao mesmo elemento e não estão separadas por combinadores. Não indique diretamente a lista .active, .pending nem o seletor .wrapper .active. :host(.active) testa o anfitrião, não o seu antepassado ou descendente; .active:host não é equivalente.
A especificidade de :host() é (0,1,0) mais a especificidade do seu argumento. Assim, :host(.active) tem especificidade (0,2,0), enquanto :host tem especificidade (0,1,0). O exemplo lê padding-left antes e depois de remover .active para testar a alteração da correspondência.
Exemplos
<!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
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.