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

CKTIS / JavaScript

HTMLTemplateElement.content: el fragmento inerte de la plantilla

`template.content` da acceso al contenido inerte de una plantilla como un `DocumentFragment`. Para reutilizar la plantilla, copia su subárbol al documento de destino e inserta la copia.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

template.content

content es una propiedad de instancia de solo lectura de HTMLTemplateElement: siempre devuelve el mismo DocumentFragment, cuyos nodos puedes leer y modificar. El marcado dentro de un elemento template ordinario se analiza y pasa a ese fragmento, no a los hijos del propio elemento. Para buscar nodos en el contenido, usa template.content.querySelector(...), no template.querySelector(...).

En un documento HTML normal, ownerDocument del fragmento apunta a otro documento sin contexto de navegación. Si la plantilla ya pertenece a un documento creado para guardar contenido de plantillas, el fragmento reutiliza ese documento. Conectar la plantilla a la página no muestra su contenido ni ejecuta los scripts que siguen en el fragmento. El carácter inerte no sustituye al saneamiento: el HTML no confiable puede seguir siendo peligroso al insertarlo. Usa textContent para insertar texto plano.

Para conservar la plantilla y reutilizarla, llama a document.importNode(template.content, true) en el documento de destino e inserta la copia. true copia también los descendientes; si omites el argumento o pasas false, obtienes una copia vacía del fragmento. A diferencia de cloneNode(true), la importación usa el contexto del documento de destino, que importa para el registro de elementos personalizados. Insertar un fragmento mueve sus hijos, no el fragmento en sí, y lo deja vacío. Si insertas el original, vacías la plantilla.

Esta es una API del DOM de HTML, no parte de ECMAScript 2024. La compatibilidad con JavaScript por sí sola no garantiza que la API esté disponible.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Template content example</title>
</head>
<body>
  <script>
    (() => {
      const template = document.createElement('template');
      const paragraph = document.createElement('p');
      paragraph.textContent = 'Hello';

      const original = template.content;
      original.appendChild(paragraph);

      const host = document.createElement('div');
      host.appendChild(template);
      document.body.appendChild(host);

      const copy = document.importNode(original, true);
      const inserted = copy.firstElementChild;
      host.appendChild(copy);

      console.log(`template children: ${template.childNodes.length}`);
      console.log(`original children: ${original.childNodes.length}`);
      console.log(`inserted: ${inserted.isConnected}, ${inserted.textContent}`);
      console.log(`copy children: ${copy.childNodes.length}`);
      host.remove();
    })();
  </script>
</body>
</html>

Resultado

template children: 0
original children: 1
inserted: true, Hello
copy children: 0

Abre el archivo HTML en un navegador y consulta la consola de las herramientas de desarrollo. La plantilla no tiene hijos directos, el fragmento original conserva su párrafo, la copia insertada del párrafo está conectada al documento y el fragmento copiado queda vacío.

Lecciones relacionadas

  • JavaScript · Lección 16 · Avanzado · Versión: 4

Fuentes