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

CKTIS / HTML

shadowrootclonable — clonar una raíz de sombra declarativa

El atributo booleano shadowrootclonable de un elemento template marca una raíz de sombra declarativa como clonable. Así, al copiar el elemento anfitrión también se puede incluir su árbol de sombra.

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

Sintaxis

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

shadowrootclonable es un atributo booleano de template que se utiliza junto con shadowrootmode. Al crear una raíz de sombra declarativa, el analizador establece su indicador de clonabilidad según la presencia del atributo. Si no está presente, el indicador es false; el atributo por sí solo no crea una raíz de sombra.

Cuando la raíz es clonable, host.cloneNode(true) también copia su árbol de sombra. No es lo mismo que copiar normalmente el contenido de la plantilla con template.content.cloneNode(true): aquí se copia el anfitrión con su raíz de sombra ya creada.

La presencia activa la opción: shadowrootclonable="false" también la activa y no es una forma válida de desactivar un atributo booleano. Para desactivar esta opción en la declaración, omite el atributo. shadowrootclonable no sustituye a shadowrootserializable: la clonación de nodos y la serialización HTML son mecanismos distintos.

El ejemplo requiere un navegador compatible con las raíces de sombra declarativas y este atributo. Abre el documento HTML completo en lugar de insertar el marcado mediante innerHTML. El modo open permite inspeccionar la copia con copy.shadowRoot; no hace falta adjuntar el anfitrión copiado al documento.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Shadow root cloning</title>
<div id="host"><template shadowrootmode="open" shadowrootclonable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  const copy = host.cloneNode(true);
  document.getElementById('result').textContent =
    copy.shadowRoot?.textContent ?? 'No shadow root';
</script>
</html>

Resultado

Hello

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