CKTIS / JavaScript
HTMLTemplateElement: неактивно съдържание на шаблон
HTMLTemplateElement съхранява съдържанието на шаблона в отделен DocumentFragment, достъпен чрез content. Съдържанието не се визуализира в шаблона; може да се копира с document.importNode() и да се вмъкне в документа, без да се изразходва оригиналът.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
const template = document.createElement("template");
template.content.append(document.createElement("p"));
const fragment = document.importNode(template.content, true);
document.body.append(fragment);Неактивно съдържание на шаблон означава съдържанието на обикновен елемент template, което се запазва за по-късна употреба, вместо да се визуализира на мястото на декларирането. Интерфейсът HTMLTemplateElement предоставя това съдържание чрез content като DocumentFragment. Това е браузърен DOM API, а не функция на ECMAScript; само наличието на Node.js 24 не доказва, че API е достъпен.
Търсете възлите на шаблона чрез template.content.querySelector(), а не чрез template.querySelector(). Парсираното съдържание принадлежи на фрагмента, а не на обикновените деца на елемента. Свойството content е само за четене, но самият фрагмент може да се променя. Тази неактивност не е същото като глобалния атрибут inert, който ограничава взаимодействието със съществуващи елементи.
Използвайте document.importNode(template.content, true), за да копирате цялото поддърво в контекста на целевия документ. Това е важно при създаването на потребителски елементи, защото съдържанието на шаблона принадлежи на отделен документ. При вмъкване на фрагмент децата му се преместват в целта и фрагментът се изпразва. Следователно директното вмъкване на template.content би изразходвало съдържанието на шаблона, вместо да го запази за повторна употреба.
Основният интерфейс и content са широко достъпни в браузърите от ноември 2015 г.; по-новите функции изискват отделни проверки за съвместимост. Примерът е за обикновен шаблон, а не за декларативен Shadow DOM: при парсване подходяща декларация, използваща shadowrootmode, може да създаде ShadowRoot вместо HTMLTemplateElement.
Примери
(() => {
const template = document.createElement("template");
const paragraph = document.createElement("p");
paragraph.textContent = "Hello";
template.content.append(paragraph);
const host = document.createElement("section");
document.body.append(host);
console.log(`before: ${host.childElementCount}`);
const fragment = document.importNode(template.content, true);
fragment.querySelector("p").textContent = "Hello, template!";
host.append(fragment);
console.log(`rendered: ${host.textContent}`);
console.log(`template: ${template.content.textContent}`);
console.log(`fragment children: ${fragment.childNodes.length}`);
host.remove();
})();Резултат
before: 0 rendered: Hello, template! template: Hello fragment children: 0
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.