CKTIS / JavaScript
HTMLTemplateElement.content: nieaktywny fragment szablonu
Właściwość `template.content` daje dostęp do nieaktywnej zawartości szablonu jako obiektu `DocumentFragment`. Aby użyć szablonu wielokrotnie, skopiuj jego poddrzewo do dokumentu docelowego i wstaw kopię.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
template.contentcontent to właściwość instancji HTMLTemplateElement tylko do odczytu: zwraca ten sam DocumentFragment, którego węzły można odczytywać i zmieniać. Znaczniki wewnątrz zwykłego elementu template są parsowane do tego fragmentu, a nie jako dzieci samego elementu. Zawartości szukaj więc przez template.content.querySelector(...), a nie przez template.querySelector(...).
W zwykłym dokumencie HTML właściwość ownerDocument fragmentu wskazuje osobny dokument bez kontekstu przeglądania. Jeśli sam szablon należy już do dokumentu utworzonego do przechowywania zawartości szablonów, fragment korzysta z tego samego dokumentu. Nawet dołączenie szablonu do strony nie powoduje renderowania zawartości ani uruchomienia skryptów, które pozostają we fragmencie. Ta nieaktywność nie zastępuje oczyszczania HTML: wstawiony niezaufany kod HTML nadal może być niebezpieczny. Do wstawiania zwykłego tekstu używaj textContent.
Aby zachować szablon do ponownego użycia, wywołaj document.importNode(template.content, true) na dokumencie docelowym, a potem wstaw kopię. true kopiuje też potomków; pominięcie flagi lub podanie false daje pustą kopię fragmentu. W przeciwieństwie do cloneNode(true) import korzysta z kontekstu dokumentu docelowego, co ma znaczenie dla rejestru elementów niestandardowych. Wstawienie fragmentu przenosi jego dzieci, nie sam fragment, i pozostawia go pustym. Jeśli wstawisz oryginał, opróżnisz szablon.
To interfejs API HTML DOM, a nie część ECMAScript 2024. Sama obsługa JavaScriptu nie gwarantuje dostępności tego interfejsu.
Przykłady
<!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>Wynik
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Otwórz plik HTML w przeglądarce i sprawdź wynik w konsoli narzędzi deweloperskich. Szablon nie ma bezpośrednich dzieci, oryginalny fragment zachowuje akapit, wstawiona kopia akapitu jest połączona z dokumentem, a skopiowany fragment jest pusty.
Powiązane lekcje
- JavaScript · Lekcja 16 · Zaawansowany · Wersja: 4