WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

::part() — freigegebene Shadow-DOM-Elemente gestalten

Das Pseudoelement ::part() ermöglicht es Styles außerhalb einer Komponente, gezielt Elemente im Shadow Tree zu gestalten, die von der Komponente ausdrücklich freigegeben wurden.

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

Syntax

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

::part() wählt Elemente im Shadow Tree aus, die über das Attribut part freigegeben wurden. Der Selektor davor zielt auf das Host-Element, nicht auf das interne Element. Zum Beispiel wählt #demo::part(label) den freigegebenen Teil label aus.

Die Argumente sind Namen, keine CSS-Selektoren. part="tab active" gibt zwei Namen frei; ::part(tab active) erfordert beide am selben Element. Die Reihenfolge spielt keine Rolle; mehrere Elemente können denselben Namen verwenden.

Dies ist kein uneingeschränktes Durchdringen der Kapselung. ::part(label) span gibt keine Nachfahren frei, und die Verkettung ::part(button)::part(label) wählt nichts aus. Teile verschachtelter Komponenten müssen über exportparts weitergereicht werden, zum Beispiel mit exportparts="label: caption".

Beispiele

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

Ergebnis

rgb(0, 128, 0)

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