Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.content

content 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

Źródła