CKTIS / HTML
template — šablona fragmentu HTML
Prvek `template` uchovává neaktivní fragment HTML, který může skript zkopírovat a vložit do dokumentu. Jeho obsah je přístupný přes `content`, nikoli jako běžné potomky prvku.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template id="item-template"><li></li></template>Prvek template deklaruje fragment HTML pro pozdější použití. Běžná šablona svůj obsah nezobrazuje; ten zůstává neaktivní, takže se v ní uložené skripty během uložení nespouštějí. Je potřeba otevírací i uzavírací značka.
Vlastnost content objektu HTMLTemplateElement zpřístupňuje DocumentFragment. Prvky zapsané mezi značkami patří do tohoto fragmentu, nikoli mezi běžné potomky prvku template. Vyhledejte je pomocí template.content.querySelector(...); přidávání potomků přímo do template porušuje jeho obsahový model.
Pomocí template.content.cloneNode(true) vytvořte hlubokou kopii struktury. Kopii doplňte a vložte do dokumentu. Vložením fragmentu se přesunou jeho potomci a samotný fragment zůstane prázdný. Vložení původního content místo kopie by šablonu vyprázdnilo.
Deklarativní Shadow DOM je samostatné použití: shadowrootmode může způsobit, že parser vytvoří kořen stínu místo běžné šablony. Následující příklad tento atribut nepoužívá.
Příklady
<!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>Výsledek
• Ada • Lin
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.