CKTIS / HTML
template — шаблон за HTML фрагмент
Елементът `template` съдържа неактивен HTML фрагмент, който скрипт може да копира и вмъкне в документа. Съдържанието му е достъпно чрез `content`, а не като обикновени деца на елемента.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<template id="item-template"><li></li></template>Елементът template декларира HTML фрагмент за по-късна употреба. Обикновеният шаблон не показва съдържанието си; то остава неактивно, затова скриптовете в него не се изпълняват, докато е съхранено там. Необходими са както отварящият, така и затварящият таг.
Свойството content на HTMLTemplateElement предоставя DocumentFragment. Елементите, записани между таговете, принадлежат на този фрагмент, а не на обикновените деца на template. Намерете ги с template.content.querySelector(...); добавянето на деца директно към template нарушава неговия модел на съдържание.
Използвайте template.content.cloneNode(true), за да копирате структурата в дълбочина. Попълнете копието и го вмъкнете в документа. При вмъкване на фрагмент неговите деца се преместват и самият фрагмент остава празен. Ако вместо копие вмъкнете оригиналния content, шаблонът ще се изпразни.
Декларативният Shadow DOM е отделен случай на употреба: shadowrootmode може да накара парсера да създаде корен в сянка вместо обикновен шаблон. Примерът по-долу не използва този атрибут.
Примери
<!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>Резултат
• Ada • Lin
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.