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

CKTIS / JavaScript

HTMLTemplateElement: contenido inerte de plantilla

HTMLTemplateElement almacena el contenido de la plantilla en un DocumentFragment independiente, accesible mediante content. El contenido no se representa dentro de la plantilla; se puede copiar con document.importNode() e insertar en el documento sin consumir el original.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

const template = document.createElement("template");
template.content.append(document.createElement("p"));
const fragment = document.importNode(template.content, true);
document.body.append(fragment);

El contenido inerte de plantilla es el contenido de un elemento template normal, que se conserva para utilizarlo más adelante en vez de representarse donde se declara. La interfaz HTMLTemplateElement expone ese contenido mediante content como un DocumentFragment. Esta es una API del DOM del navegador, no una característica de ECMAScript; la mera disponibilidad de Node.js 24 no demuestra que esté disponible.

Busca los nodos de la plantilla mediante template.content.querySelector(), no mediante template.querySelector(). El contenido analizado pertenece al fragmento, no a los hijos normales del elemento. La propiedad content es de solo lectura, pero el fragmento en sí se puede modificar. Esta inactividad no es lo mismo que el atributo global inert, que limita la interacción con elementos existentes.

Usa document.importNode(template.content, true) para copiar todo el subárbol en el contexto del documento de destino. Esto es importante al crear elementos personalizados, porque el contenido de la plantilla pertenece a un documento independiente. Al insertar un fragmento, sus hijos se trasladan al destino y el fragmento queda vacío. Por tanto, insertar directamente template.content consumiría el contenido de la plantilla en vez de conservarlo para reutilizarlo.

La interfaz básica y content están ampliamente disponibles en los navegadores desde noviembre de 2015; las funciones más recientes requieren comprobaciones de compatibilidad por separado. El ejemplo trata de una plantilla normal, no de Shadow DOM declarativo: durante el análisis, una declaración adecuada que use shadowrootmode puede crear un ShadowRoot en lugar de un HTMLTemplateElement.

Ejemplos

(() => {
  const template = document.createElement("template");
  const paragraph = document.createElement("p");
  paragraph.textContent = "Hello";
  template.content.append(paragraph);

  const host = document.createElement("section");
  document.body.append(host);
  console.log(`before: ${host.childElementCount}`);

  const fragment = document.importNode(template.content, true);
  fragment.querySelector("p").textContent = "Hello, template!";
  host.append(fragment);

  console.log(`rendered: ${host.textContent}`);
  console.log(`template: ${template.content.textContent}`);
  console.log(`fragment children: ${fragment.childNodes.length}`);
  host.remove();
})();

Resultado

before: 0
rendered: Hello, template!
template: Hello
fragment children: 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