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.