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

CKTIS / HTML

shadowrootserializable — serializar una raíz shadow declarativa

El atributo booleano shadowrootserializable marca una raíz shadow declarativa para serializarla mediante getHTML({ serializableShadowRoots: true }). No la incluye automáticamente en el resultado habitual de getHTML() ni en el innerHTML del host.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<template shadowrootmode="open" shadowrootserializable>…</template>

shadowrootserializable es un atributo booleano del elemento template. Cuando el analizador crea una raíz shadow declarativa a partir de shadowrootmode="open" o shadowrootmode="closed", la presencia de este atributo activa su indicador de serialización. shadowrootserializable por sí solo, sin un shadowrootmode válido, no crea una raíz shadow. Para desactivar la opción, omite el atributo; shadowrootserializable="false" también cuenta como presente.

La llamada host.getHTML({ serializableShadowRoots: true }) incluye la raíz shadow marcada como marcado declarativo template con su contenido. La llamada habitual host.getHTML() y la lectura de host.innerHTML omiten la raíz shadow del host. La opción shadowRoots de getHTML() permite seleccionar explícitamente las raíces que se van a serializar, independientemente de su indicador de serialización.

La serialización no es clonación: shadowrootserializable no sustituye a shadowrootclonable. Tampoco es un mecanismo de protección de datos. Una raíz marcada en modo closed también puede aparecer al serializar su host, así que no guardes secretos en ella suponiendo que ese modo impedirá exportarlos.

Carga el ejemplo como documento HTML para que el analizador cree la raíz shadow declarativa. Asignar el mismo marcado a innerHTML no la creará. Las tres comprobaciones muestran que la raíz se omite de forma predeterminada y que su atributo y contenido aparecen al activar la serialización.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>shadowrootserializable</title>
<div id="host"><template shadowrootmode="open" shadowrootserializable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  const html = host.getHTML({ serializableShadowRoots: true });
  document.getElementById('result').textContent = [
    host.getHTML() === '',
    html.includes('shadowrootserializable=""'),
    html.includes('<span>Hello</span>')
  ].join('\n');
</script>
</html>

Resultado

true
true
true

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