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.