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

CKTIS / HTML

shadowrootmode — Shadow DOM declarativo

El atributo shadowrootmode de template permite que el analizador HTML cree una raíz shadow declarativa. Sus valores open y closed determinan el modo de acceso a esa raíz.

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

Sintaxis

<template shadowrootmode="open|closed">…</template>

shadowrootmode es un atributo enumerado de template, no un atributo booleano. Acepta open o closed. La ausencia del atributo, un valor vacío y un valor no válido indican el estado None: por sí solo, el atributo no activa entonces la creación de una raíz shadow.

Al analizar un documento HTML, una declaración válida crea una raíz shadow en el elemento padre si este puede alojar Shadow DOM. El contenido de la declaración pasa a la raíz shadow, mientras que el propio template no se convierte en un hijo DOM del host. Si el host ya tiene una raíz shadow o no se permite adjuntar una, el analizador deja un template normal.

El modo open permite obtener la raíz mediante host.shadowRoot; con closed, esa propiedad devuelve null. Ambos modos crean Shadow DOM: closed no significa que el contenido no vaya a representarse.

Este es un mecanismo del analizador, no un interruptor retroactivo: añadir shadowrootmode a un template existente no crea una raíz shadow. Asignar el marcado a innerHTML tampoco activa el Shadow DOM declarativo. Abre el ejemplo como documento HTML, en lugar de insertarlo mediante innerHTML.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Declarative shadow DOM</title>
<div id="host"><template shadowrootmode="open"><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  document.getElementById('result').textContent = [
    host.shadowRoot.mode,
    host.shadowRoot.querySelector('span').textContent,
    String(host.querySelector('template'))
  ].join('\n');
</script>
</html>

Resultado

open
Hello
null

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