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

CKTIS / CSS

:host() — sélectionner conditionnellement un hôte Shadow DOM

La pseudo-classe :host() sélectionne un élément hôte Shadow DOM lorsqu’il correspond au sélecteur entre parenthèses. Elle s’applique dans le contexte de l’arbre d’ombre de cet hôte et permet de faire dépendre ses styles d’une classe, d’un attribut ou d’une autre condition.

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

Syntaxe

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

:host() est une pseudo-classe fonctionnelle utilisée dans la feuille de style d’un arbre d’ombre. Elle sélectionne l’hôte de cet arbre si celui-ci correspond à son argument. En dehors du contexte d’un arbre d’ombre, elle ne correspond à rien. À l’inverse, :host ne nécessite aucune condition supplémentaire.

L’argument est un sélecteur composé (<compound-selector>), comme .active ou .active[disabled] : ses conditions portent sur le même élément et ne sont pas séparées par des combinateurs. Ne fournissez pas directement la liste .active, .pending ni le sélecteur .wrapper .active. :host(.active) vérifie l’hôte, et non son ancêtre ou son descendant ; .active:host n’est pas équivalent.

La spécificité de :host() est (0,1,0) plus celle de son argument. Ainsi, :host(.active) a une spécificité de (0,2,0), tandis que :host a une spécificité de (0,1,0). L’exemple lit padding-left avant et après la suppression de .active afin de tester le changement de correspondance.

Exemples

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

Résultat

12px
0px

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