CKTIS / HTML
template — una plantilla de fragmento HTML
El elemento `template` contiene un fragmento HTML inerte que un script puede copiar e insertar en el documento. Su contenido está disponible mediante `content`, no como hijos ordinarios del elemento.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<template id="item-template"><li></li></template>El elemento template declara un fragmento HTML para usarlo más adelante. Una plantilla ordinaria no muestra su contenido; este permanece inerte, por lo que los scripts que contiene no se ejecutan mientras está almacenado allí. Se necesitan tanto la etiqueta de apertura como la de cierre.
La propiedad content de HTMLTemplateElement expone un DocumentFragment. Los elementos escritos entre las etiquetas pertenecen a ese fragmento, no a los hijos ordinarios de template. Búscalos con template.content.querySelector(...); añadir hijos directamente a template infringe su modelo de contenido.
Usa template.content.cloneNode(true) para copiar la estructura en profundidad. Completa la copia e insértala en el documento. Al insertar un fragmento, sus hijos se trasladan y el fragmento queda vacío. Insertar el content original en vez de una copia vaciaría la plantilla.
El DOM sombreado declarativo es un uso distinto: shadowrootmode puede hacer que el analizador cree una raíz sombreada en lugar de una plantilla ordinaria. El siguiente ejemplo no usa ese atributo.
Ejemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Template example</title>
</head>
<body>
<template id="item-template"><li></li></template>
<ul id="items"></ul>
<script>
const template = document.getElementById('item-template');
const items = document.getElementById('items');
for (const name of ['Ada', 'Lin']) {
const fragment = template.content.cloneNode(true);
fragment.querySelector('li').textContent = name;
items.appendChild(fragment);
}
</script>
</body>
</html>Resultado
• Ada • Lin
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.