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

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

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

Източници