HTML элемент контент шаблона <template>
- это механизм для отложенного создания клиентского контента, который не отображается во время загрузки, но может быть инициализирован при помощи JavaScript.
Шаблон можно представить себе как фрагмент контента, сохранённый для последующего использования в документе. Хотя парсер и обрабатывает содержимое элемента <template>
во время загрузки страницы, он делает это только чтобы убедиться в валидности содержимого; само содержимое при этом не отображается.
Категории контента | Metadata content, flow content, phrasing content, script-supporting element |
---|---|
Допустимый контент | Нет ограничений |
Закрывающий тег | {{no_tag_omission}} |
Разрешенные родители | Any element that accepts metadata content, phrasing content, or script-supporting elements. Also allowed as a child of a {{HTMLElement("colgroup")}} element that does not have a {{htmlattrxref("span", "colgroup")}} attribute. |
Неявные роли ARIA | Нет соответствующей роли |
Разрешенные роли ARIA | Отсутствует |
DOM интерфейс | {{domxref("HTMLTemplateElement")}} |
Элемент может иметь общие атрибуты.
Также есть доступный только для чтения атрибут 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:
table { background: #000; } table td { background: #fff; }
{{EmbedLiveSample("Example", 500, 120)}}
Спецификация | Статус | Комментарий |
---|---|---|
{{SpecName('HTML WHATWG','/scripting-1.html#the-template-element','template element')}} | {{Spec2('HTML WHATWG')}} | No change |
{{SpecName('HTML5 W3C','/scripting-1.html#the-template-element','template element')}} | {{Spec2('HTML5 W3C')}} | Initial definition |
{{Compat("html.elements.template")}}