Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

:host — stylowanie hosta Shadow DOM

Pseudoklasa :host pozwala arkuszowi wewnątrz Shadow DOM wybrać element hosta. Poza kontekstem drzewa cienia nie dopasowuje niczego.

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

Składnia

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

:host wybiera hosta drzewa cienia, czyli element, do którego dołączono shadow root. Regułę umieszcza się w arkuszu tego drzewa; w arkuszu dokumentu :host nie dopasowuje niczego.

Selektor wybiera hosta, nie jego wewnętrzne elementy. Jego specyficzność wynosi (0,1,0). Wariant :host(.active) dodatkowo sprawdza klasę hosta i ma specyficzność (0,2,0); argumentem jest selektor złożony bez kombinatorów, nie lista selektorów.

W przykładzie arkusz wewnątrz shadow root ustawia display i padding elementu host. Wynik odczytuje style obliczone hosta, a nie elementu span.

Przykłady

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

Wynik

display: block
padding: 8px

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła