WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

:host — einen Shadow-DOM-Host gestalten

Die Pseudoklasse :host ermöglicht es einem Stylesheet innerhalb des Shadow DOM, das Host-Element auszuwählen. Außerhalb eines Shadow-Tree-Kontexts trifft sie auf kein Element zu.

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

Syntax

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

:host wählt den Host eines Shadow Trees aus: das Element, an das die Shadow Root angehängt ist. Die Regel gehört in das Stylesheet dieses Trees; in einem Stylesheet des Dokuments trifft :host auf kein Element zu.

Der Selektor zielt auf den Host, nicht auf dessen interne Elemente. Seine Spezifität beträgt (0,1,0). Die Variante :host(.active) prüft zusätzlich die Klasse des Hosts und hat die Spezifität (0,2,0); ihr Argument ist ein zusammengesetzter Selektor ohne Kombinatoren, keine Selektorliste.

Im Beispiel setzt das Stylesheet innerhalb der Shadow Root display und padding für host. Das Ergebnis liest die berechneten Stile des Hosts aus, nicht die des span-Elements.

Beispiele

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

Ergebnis

display: block
padding: 8px

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen