Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

::part() — applicare stili agli elementi Shadow DOM esposti

Lo pseudo-elemento ::part() consente agli stili esterni a un componente di selezionare gli elementi del suo shadow tree esposti esplicitamente.

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

Sintassi

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

::part() seleziona gli elementi dello shadow tree esposti tramite l’attributo part. Il selettore che lo precede si riferisce all’host, non all’elemento interno. Per esempio, #demo::part(label) seleziona la parte esposta label.

Gli argomenti sono nomi, non selettori CSS. part="tab active" espone due nomi; ::part(tab active) richiede che entrambi siano presenti sullo stesso elemento. L’ordine non conta; più elementi possono condividere un nome.

Questo non consente di oltrepassare liberamente l’incapsulamento. ::part(label) span non espone i discendenti e concatenare ::part(button)::part(label) non seleziona nulla. Le parti dei componenti annidati devono essere inoltrate tramite exportparts, per esempio con exportparts="label: caption".

Esempi

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

Risultato

rgb(0, 128, 0)

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti