WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

template — eine HTML-Fragmentvorlage

Das Element `template` enthält ein inaktives HTML-Fragment, das ein Skript kopieren und in das Dokument einfügen kann. Auf seinen Inhalt greift man über `content` zu, nicht über gewöhnliche Kindelemente des Elements.

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

Syntax

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

Das Element template deklariert ein HTML-Fragment zur späteren Verwendung. Eine gewöhnliche Vorlage zeigt ihren Inhalt nicht an; er bleibt inaktiv, sodass darin enthaltene Skripte während der Speicherung nicht ausgeführt werden. Sowohl das öffnende als auch das schließende Tag sind erforderlich.

Die Eigenschaft content von HTMLTemplateElement stellt ein DocumentFragment bereit. Elemente zwischen den Tags gehören zu diesem Fragment und nicht zu den gewöhnlichen Kindelementen von template. Suche sie mit template.content.querySelector(...); Kinder direkt zu template hinzuzufügen, verletzt dessen Inhaltsmodell.

Verwende template.content.cloneNode(true), um die Struktur tief zu kopieren. Fülle die Kopie und füge sie in das Dokument ein. Beim Einfügen eines Fragments werden dessen Kinder verschoben, sodass das Fragment selbst leer bleibt. Würde statt einer Kopie das ursprüngliche content eingefügt, wäre die Vorlage leer.

Eine andere Verwendung ist das deklarative Shadow DOM: shadowrootmode kann bewirken, dass der Parser statt einer gewöhnlichen Vorlage eine Shadow Root erstellt. Das folgende Beispiel verwendet dieses Attribut nicht.

Beispiele

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

Ergebnis

• Ada
• Lin

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen