CKTIS / JavaScript
HTMLTemplateElement.content: das inerte Vorlagenfragment
`template.content` stellt den inerten Inhalt einer Vorlage als `DocumentFragment` bereit. Um die Vorlage wiederzuverwenden, kopiere ihren Teilbaum in das Zieldokument und füge die Kopie ein.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
template.contentcontent ist eine schreibgeschützte Instanzeigenschaft von HTMLTemplateElement: Sie liefert immer dasselbe DocumentFragment, dessen Knoten du lesen und ändern kannst. Das Markup in einem gewöhnlichen template-Element wird in dieses Fragment eingelesen, nicht als Kinder des Elements selbst. Suche im Inhalt daher mit template.content.querySelector(...), nicht mit template.querySelector(...).
In einem normalen HTML-Dokument verweist ownerDocument des Fragments auf ein separates Dokument ohne Browserkontext. Gehört die Vorlage bereits zu einem Dokument, das für Vorlageninhalte angelegt wurde, verwendet das Fragment dieses Dokument. Auch wenn du die Vorlage mit der Seite verbindest, wird ihr Inhalt nicht dargestellt, und Skripte, die noch im Fragment liegen, werden nicht ausgeführt. Inertheit ersetzt keine HTML-Bereinigung: Nicht vertrauenswürdiges HTML kann beim Einfügen weiterhin gefährlich sein. Verwende textContent für reinen Text.
Damit die Vorlage wiederverwendbar bleibt, rufe document.importNode(template.content, true) auf dem Zieldokument auf und füge anschließend die Kopie ein. true kopiert auch die Nachfahren; ohne dieses Argument oder mit false erhältst du eine leere Kopie des Fragments. Anders als cloneNode(true) verwendet der Import den Kontext des Zieldokuments, was für die Registrierung benutzerdefinierter Elemente wichtig ist. Beim Einfügen eines Fragments werden seine Kinder verschoben, nicht das Fragment selbst, und das Fragment bleibt leer zurück. Fügst du das Original ein, leerst du die Vorlage.
Das ist eine HTML-DOM-API und kein Bestandteil von ECMAScript 2024. JavaScript-Unterstützung allein garantiert nicht, dass diese API verfügbar ist.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Template content example</title>
</head>
<body>
<script>
(() => {
const template = document.createElement('template');
const paragraph = document.createElement('p');
paragraph.textContent = 'Hello';
const original = template.content;
original.appendChild(paragraph);
const host = document.createElement('div');
host.appendChild(template);
document.body.appendChild(host);
const copy = document.importNode(original, true);
const inserted = copy.firstElementChild;
host.appendChild(copy);
console.log(`template children: ${template.childNodes.length}`);
console.log(`original children: ${original.childNodes.length}`);
console.log(`inserted: ${inserted.isConnected}, ${inserted.textContent}`);
console.log(`copy children: ${copy.childNodes.length}`);
host.remove();
})();
</script>
</body>
</html>Ergebnis
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Öffne die HTML-Datei im Browser und sieh dir die Ausgabe in der Konsole der Entwicklerwerkzeuge an. Die Vorlage hat keine direkten Kinder, das Originalfragment behält seinen Absatz, die eingefügte Absatzkopie ist mit dem Dokument verbunden, und das kopierte Fragment ist leer.
Zugehörige Lektionen
- JavaScript · Lektion 16 · Fortgeschritten · Version: 4