<template>

HTML элемент контент шаблона <template> - это механизм для отложенного создания клиентского контента, который не отображается во время загрузки, но может быть инициализирован при помощи JavaScript.

Шаблон можно представить себе как фрагмент контента, сохранённый для последующего использования в документе. Хотя парсер и обрабатывает содержимое элемента <template> во время загрузки страницы, он делает это только чтобы убедиться в валидности содержимого; само содержимое при этом не отображается.

Категории контента Metadata content, flow content, phrasing content, script-supporting element
Допустимый контент Нет ограничений
Закрывающий тег Нет, открывающий и закрывающий теги обязательны.
Разрешённые родители Any element that accepts metadata content, phrasing content, or script-supporting elements. Also allowed as a child of a <colgroup> (en-US) element that does not have a span (en-US) attribute.
Неявные роли ARIA Нет соответствующей роли
Разрешённые роли ARIA Отсутствует
DOM интерфейс HTMLTemplateElement (en-US)

Атрибуты

Элемент может иметь общие атрибуты.

Также есть доступный только для чтения атрибут content, который предоставляет доступ к содержимому шаблона. Проверка на наличие этого атрибута является распространённым способом определить, поддерживает ли браузер элемент <template>.

Примеры

Начнём с HTML.

<table id="producttable">
  <thead>
    <tr>
      <td>UPC_Code</td>
      <td>Product_Name</td>
    </tr>
  </thead>
  <tbody>
    <!-- existing data could optionally be included here -->
  </tbody>
</table>

<template id="productrow">
  <tr>
    <td class="record"></td>
    <td></td>
  </tr>
</template>

Для начала у нас есть таблица, в которую мы собираемся вставить содержимое с помощью Javascript кода. Затем следует шаблон, который описывает структуру HTML фрагмента представляющего одну строку таблицы

Теперь, когда таблица была создана и шаблон определён, мы используем JavaScript чтобы вставить строки в таблицу. Каждая строка строится с использованием шаблона.

// Проверяем поддерживает ли браузер тег <template>
// проверив наличие атрибута content у элемента template
if ('content' in document.createElement('template')) {

  // Instantiate the table with the existing HTML tbody and the row with the template
  var t = document.querySelector('#productrow'),
  td = t.content.querySelectorAll("td");
  td[0].textContent = "1235646565";
  td[1].textContent = "Stuff";

  // клонируем новую строку и вставляем её в таблицу
  var tb = document.getElementsByTagName("tbody");
  var clone = document.importNode(t.content, true);
  tb[0].appendChild(clone);

  // создаём новую строку
  td[0].textContent = "0384928528";
  td[1].textContent = "Acme Kidney Beans";

 // клонируем новую строку и вставляем её в таблицу
  var clone2 = document.importNode(t.content, true);
  tb[0].appendChild(clone2);

} else {
  // необходимо найти другой способ добавить строку в таблицу т.к.
  // тег <template> не поддерживается браузером
}

Как результат имеем HTML таблицу с двумя новыми строками добавленными с помощью JavaScript:

Спецификации

Спецификация Статус Комментарий
HTML Living Standard
Определение 'template element' в этой спецификации.
Живой стандарт No change
HTML5
Определение 'template element' в этой спецификации.
Рекомендация Initial definition

Совместимость браузера

BCD tables only load in the browser

Смотрите также