Cómo crear plantillas reutilizables con template en HTML

Un listado de próximos talleres tiene varias tarjetas con la misma estructura. Si construyes cada tarjeta concatenando HTML, un cambio de marcado acaba mezclado con la lógica que carga los datos. Template en HTML permite conservar una estructura que puedes editar y clonar.

Contenido inerte y copias independientes

El contenido de template se guarda en un DocumentFragment accesible desde content. No aparece hasta que insertas una copia en el documento. Clona con cloneNode(true) para copiar los descendientes y asigna contenido con textContent.

Ejemplo para probar

Copia el archivo completo como index.html y ábrelo en tu navegador.

<!doctype html>
<html lang="es">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Práctica de HTML</title>
  <style>
    body { font: 1rem/1.6 system-ui, sans-serif; margin: 2rem auto; padding-inline: 1rem; max-width: 48rem; }
    img { max-width: 100%; height: auto; }
    input, button { font: inherit; }
  </style>
</head>
<body>
  <ul id="talleres"></ul>
  <template id="ficha">
    <li><strong class="nombre"></strong> <span class="turno"></span></li>
  </template>
  <script>
    const plantilla = document.querySelector('#ficha');
    const lista = document.querySelector('#talleres');
    const talleres = [{ nombre: 'Grabado', turno: '10:00' }, { nombre: 'Encuadernación', turno: '12:00' }];
    for (const taller of talleres) {
      const copia = plantilla.content.cloneNode(true);
      copia.querySelector('.nombre').textContent = taller.nombre;
      copia.querySelector('.turno').textContent = taller.turno;
      lista.append(copia);
    }
  </script>
</body>
</html>

Coloca el fragmento al final del body. Añade un tercer taller al array. Después agrega una clase a la etiqueta li de la plantilla y observa cómo se aplica a todas las instancias.

Cómo comprobar el resultado

Inspecciona el DOM y comprueba que la lista contiene dos elementos al cargar. Actualiza un nombre con una cadena que incluya signos de etiqueta. Debe aparecer como texto, porque se asignó con textContent.

Un error que conviene evitar

Mover plantilla.content directamente a la lista vacía el fragmento y dificulta reutilizarlo. Tampoco conviene incluir un id fijo dentro de cada copia si luego se insertarán varias en la misma página.

Cómo adaptar el ejemplo a tu página

Para controles repetidos, registra eventos en el contenedor cuando te sirva la delegación. Para contenido importante que debe estar visible al cargar sin JavaScript, genera el listado en el HTML inicial.

Dibuja la estructura antes de rellenarla

Empieza con una tarjeta escrita a mano que muestre un solo taller. Marca qué piezas cambian entre registros. En este caso cambian el nombre y la hora. El elemento que envuelve ambos conserva la semántica de una lista.

Cuando pases el ejemplo a template, deja dentro las clases, los elementos y el orden de lectura. Conserva los valores en el array o en los datos recibidos. Así, quien revise la interfaz puede descubrir qué se repetirá sin recorrer todas las ramas del script.

Entiende qué ocurre al insertar un fragmento

La propiedad content entrega un fragmento de documento. Al insertar un fragmento en la lista, sus hijos pasan al destino. La copia queda vacía después de append, porque sus hijos ya forman parte de la página. La plantilla original sigue disponible ya que se clonó antes.

Si tu diseño tiene varios campos, rellénalos antes de insertar la copia. Si necesitas usar una referencia más tarde, guarda el elemento concreto que acabas de crear o consulta la tarjeta por una clave estable.

Añade datos reales sin tratarlos como HTML

Prueba un taller cuyo nombre contenga signos de menor y mayor. Al asignarlo con textContent, debe leerse con los signos originales y no aparecer como etiqueta. Para enlaces, crea el atributo después de validar el protocolo y el destino según las reglas de tu aplicación.

Usa rutas internas cuando enlaces a registros propios. Distingue los datos que tienen texto visible de los que se usan como identificadores. El nombre del evento puede cambiar. Un identificador estable ayuda a encontrar la tarjeta al actualizar su información.

Controla el caso de una lista vacía

Borra los elementos del array y recarga el ejemplo. La lista queda vacía. En un proyecto real, sustituye ese silencio por un mensaje que diga de dónde saldrán los próximos talleres o cómo ajustar el filtro. Si se cargan por red, distingue entre la espera, una respuesta sin resultados y un error de conexión.

Prepara los mensajes junto con el diseño de la tarjeta. Prueba también cargar dos veces para detectar duplicados. Decide si una actualización añade registros o reemplaza todos los visibles.

Prepara las acciones de las tarjetas repetidas

Si cada taller se puede guardar, añade un botón dentro de la plantilla y ponle un nombre comprensible en contexto. Al clonar, relaciona el botón con el taller mediante su propia tarjeta. Si un campo necesita una etiqueta vinculada por id, genera un identificador distinto en cada copia.

Comprueba que pulsar el control de la primera tarjeta no modifica otra. Después recorre la lista con el teclado y verifica que el orden visible coincida con el orden de navegación.

Personaliza el orden sin reconstruir el marcado

Con un array breve, puedes ensayar dos ordenaciones antes de insertar las copias. Ordena por hora en una y por nombre en otra. Comprueba que las tarjetas siguen mostrando las dos propiedades aunque cambie el recorrido de los datos.

Si la hora se proporciona como texto, usa un formato fijo para una comparación coherente o trabaja con un valor temporal estructurado. Al reorganizar elementos que ya están en pantalla, comprueba dónde queda el foco. Los cambios que reordenan una lista pueden resultar confusos si la persona está usando un control de esa lista.

Sigue practicando con Qué es el DOM en JavaScript y cómo manipularlo.

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *

logo mastercode pro
Resumen de privacidad

Esta web utiliza cookies para que podamos ofrecerte la mejor experiencia de usuario posible. La información de las cookies se almacena en tu navegador y realiza funciones tales como reconocerte cuando vuelves a nuestra web o ayudar a nuestro equipo a comprender qué secciones de la web encuentras más interesantes y útiles.

Puedes ver mas detalle en nuestra pagina de privcidad