KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

template — een HTML-fragmentsjabloon

Het element `template` bevat een inert HTML-fragment dat een script kan kopiëren en in het document kan invoegen. De inhoud is toegankelijk via `content`, niet als gewone kinderen van het element.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<template id="item-template"><li></li></template>

Het element template declareert een HTML-fragment voor later gebruik. Een gewone template toont de inhoud niet; die blijft inert, zodat scripts erin niet worden uitgevoerd zolang de inhoud daar is opgeslagen. Zowel de openingstag als de sluitingstag zijn vereist.

De eigenschap content van HTMLTemplateElement geeft toegang tot een DocumentFragment. Elementen tussen de tags behoren tot dat fragment, niet tot de gewone kinderen van template. Zoek ze met template.content.querySelector(...); rechtstreeks kinderen toevoegen aan template schendt het contentmodel.

Gebruik template.content.cloneNode(true) om de structuur diep te kopiëren. Vul de kopie in en voeg die aan het document toe. Bij het invoegen van een fragment worden de kinderen verplaatst, waardoor het fragment zelf leeg achterblijft. Het oorspronkelijke content invoegen in plaats van een kopie zou de template leegmaken.

Declarative Shadow DOM is een afzonderlijke toepassing: shadowrootmode kan ervoor zorgen dat de parser een shadow root maakt in plaats van een gewone template. Het onderstaande voorbeeld gebruikt dat attribuut niet.

Voorbeelden

<!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>

Resultaat

• Ada
• Lin

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen