Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

::part() — stylowanie udostępnionych elementów Shadow DOM

Pseudo-element ::part() pozwala stylować z zewnątrz elementy drzewa cienia jawnie udostępnione przez komponent.

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

Składnia

host-selector::part(<ident>+) { /* declarations */ }

::part() wybiera elementy udostępnione atrybutem part w drzewie cienia. Selektor przed nim wskazuje hosta, nie element wewnętrzny. Przykładowo #demo::part(label) wybiera udostępnioną część label.

Argumenty to nazwy, nie selektory CSS. part="tab active" udostępnia dwie nazwy; ::part(tab active) wymaga obu na tym samym elemencie. Kolejność nie ma znaczenia; wiele elementów może współdzielić nazwę.

To nie jest ogólne obejście hermetyzacji. ::part(label) span nie udostępnia potomków, a łańcuch ::part(button)::part(label) niczego nie wybiera. Części z zagnieżdżonego komponentu trzeba przekazać przez exportparts, np. exportparts="label: caption".

Przykłady

<!doctype html>
<meta charset="utf-8">
<title>Shadow part example</title>
<style>
  #demo::part(label) { color: rgb(0, 128, 0); }
</style>
<div id="demo"></div>
<script>
  const host = document.getElementById('demo');
  const root = host.attachShadow({ mode: 'open' });
  const label = document.createElement('span');
  label.setAttribute('part', 'label');
  label.textContent = 'Ready';
  root.append(label);
  console.log(getComputedStyle(label).color);
</script>

Wynik

rgb(0, 128, 0)

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

Źródła