Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

:host — styliser un hôte Shadow DOM

La pseudo-classe :host permet à une feuille de style située dans le Shadow DOM de sélectionner son élément hôte. En dehors du contexte d’un arbre d’ombre, elle ne correspond à aucun élément.

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

Syntaxe

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

:host sélectionne l’hôte d’un arbre d’ombre : l’élément auquel la racine d’ombre est attachée. Placez la règle dans la feuille de style de cet arbre ; dans une feuille de style du document, :host ne correspond à rien.

Le sélecteur cible l’hôte, et non ses éléments internes. Sa spécificité est (0,1,0). La variante :host(.active) vérifie aussi la classe de l’hôte et a une spécificité de (0,2,0) ; son argument est un sélecteur composé sans combinateurs, et non une liste de sélecteurs.

Dans l’exemple, la feuille de style située dans la racine d’ombre définit display et padding pour host. Le résultat lit les styles calculés de l’hôte, et non ceux de l’élément span.

Exemples

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

Résultat

display: block
padding: 8px

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources