WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLTemplateElement: inaktiver Template-Inhalt

HTMLTemplateElement speichert Template-Inhalt in einem separaten DocumentFragment, das über content zugänglich ist. Der Inhalt wird innerhalb des Templates nicht dargestellt. Mit document.importNode() lässt er sich kopieren und in das Dokument einfügen, ohne das Original zu verbrauchen.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

const template = document.createElement("template");
template.content.append(document.createElement("p"));
const fragment = document.importNode(template.content, true);
document.body.append(fragment);

Inaktiver Template-Inhalt bezeichnet den Inhalt eines gewöhnlichen template-Elements, der zur späteren Verwendung bereitgehalten wird, statt an der Stelle seiner Deklaration dargestellt zu werden. Die Schnittstelle HTMLTemplateElement stellt diesen Inhalt über content als DocumentFragment bereit. Dies ist eine Browser-DOM-API und keine ECMAScript-Funktion; allein die Verfügbarkeit von Node.js 24 belegt nicht, dass sie verfügbar ist.

Suche Template-Knoten mit template.content.querySelector() und nicht mit template.querySelector(). Geparster Inhalt gehört zum Fragment, nicht zu den gewöhnlichen Kindern des Elements. Die Eigenschaft content ist schreibgeschützt, das Fragment selbst lässt sich jedoch ändern. Diese Inaktivität ist nicht dasselbe wie das globale Attribut inert, das die Interaktion mit vorhandenen Elementen einschränkt.

Verwende document.importNode(template.content, true), um den gesamten Teilbaum im Kontext des Zieldokuments zu kopieren. Das ist für die Erstellung benutzerdefinierter Elemente wichtig, da Template-Inhalt zu einem separaten Dokument gehört. Beim Einfügen eines Fragments werden seine Kinder in das Ziel verschoben und das Fragment wird geleert. Würde template.content direkt eingefügt, würde der Template-Inhalt daher verbraucht, statt zur Wiederverwendung erhalten zu bleiben.

Die Kern-Schnittstelle und content sind seit November 2015 in Browsern weit verbreitet; neuere Funktionen müssen separat auf Kompatibilität geprüft werden. Das Beispiel behandelt ein gewöhnliches Template, nicht deklaratives Shadow DOM: Beim Parsen kann eine passende Deklaration mit shadowrootmode anstelle eines HTMLTemplateElement ein ShadowRoot erzeugen.

Beispiele

(() => {
  const template = document.createElement("template");
  const paragraph = document.createElement("p");
  paragraph.textContent = "Hello";
  template.content.append(paragraph);

  const host = document.createElement("section");
  document.body.append(host);
  console.log(`before: ${host.childElementCount}`);

  const fragment = document.importNode(template.content, true);
  fragment.querySelector("p").textContent = "Hello, template!";
  host.append(fragment);

  console.log(`rendered: ${host.textContent}`);
  console.log(`template: ${template.content.textContent}`);
  console.log(`fragment children: ${fragment.childNodes.length}`);
  host.remove();
})();

Ergebnis

before: 0
rendered: Hello, template!
template: Hello
fragment children: 0

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