Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

template — szablon fragmentu HTML

Element `template` przechowuje nieaktywny fragment HTML, który skrypt może skopiować i wstawić do dokumentu. Jego zawartość jest dostępna przez `content`, a nie jako zwykłe dzieci elementu.

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

Składnia

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

Element template deklaruje fragment HTML do późniejszego wykorzystania. Zwykły szablon nie wyświetla swojej zawartości; pozostaje ona nieaktywna, więc umieszczone w niej skrypty nie wykonują się podczas przechowywania. Wymagane są znacznik otwierający i zamykający.

Właściwość content obiektu HTMLTemplateElement udostępnia DocumentFragment. Elementy zapisane między znacznikami trafiają do tego fragmentu, a nie do zwykłych dzieci template. Wyszukuj je przez template.content.querySelector(...); dodawanie dzieci bezpośrednio do template narusza jego model zawartości.

Użyj template.content.cloneNode(true), aby głęboko skopiować strukturę. Uzupełnij kopię i wstaw ją do dokumentu. Wstawienie fragmentu przenosi jego dzieci, pozostawiając sam fragment pusty. Wstawienie oryginalnego content zamiast kopii opróżniłoby szablon.

Osobnym zastosowaniem jest deklaratywny Shadow DOM: shadowrootmode może spowodować utworzenie korzenia cienia przez parser zamiast zwykłego szablonu. Poniższy przykład nie używa tego atrybutu.

Przykłady

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

Wynik

• Ada
• Lin

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła