База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници