Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

::part() — aplicar estilos a elementos expuestos del Shadow DOM

El pseudoelemento ::part() permite que los estilos externos a un componente seleccionen elementos del árbol shadow que el componente expone explícitamente.

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

Sintaxis

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

::part() selecciona elementos del árbol shadow expuestos mediante el atributo part. El selector que lo precede apunta al host, no al elemento interno. Por ejemplo, #demo::part(label) selecciona la parte expuesta label.

Los argumentos son nombres, no selectores CSS. part="tab active" expone dos nombres; ::part(tab active) exige que ambos estén en el mismo elemento. El orden no importa; varios elementos pueden compartir un nombre.

Esto no permite atravesar la encapsulación sin restricciones. ::part(label) span no expone descendientes, y encadenar ::part(button)::part(label) no selecciona nada. Las partes de componentes anidados deben reenviarse mediante exportparts, por ejemplo, con exportparts="label: caption".

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes