Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

::part() — aplicar estilos a elementos Shadow DOM expostos

O pseudo-elemento ::part() permite que estilos externos a um componente selecionem elementos da árvore shadow que o componente expõe explicitamente.

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

Sintaxe

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

::part() seleciona elementos da árvore shadow expostos através do atributo part. O seletor que o antecede aponta para o anfitrião, não para o elemento interno. Por exemplo, #demo::part(label) seleciona a parte exposta label.

Os argumentos são nomes, não seletores CSS. part="tab active" expõe dois nomes; ::part(tab active) exige que ambos estejam no mesmo elemento. A ordem não importa; vários elementos podem partilhar um nome.

Isto não permite contornar a encapsulação sem restrições. ::part(label) span não expõe descendentes e encadear ::part(button)::part(label) não seleciona nada. As partes de componentes aninhados têm de ser encaminhadas através de exportparts, por exemplo com exportparts="label: caption".

Exemplos

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

Resultado

rgb(0, 128, 0)

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes