CKTIS / JavaScript
HTMLTemplateElement.content: неактивният фрагмент на шаблона
`template.content` дава достъп до неактивното съдържание на шаблон като `DocumentFragment`. За да използваш шаблона отново, копирай поддървото му в целевия документ и вмъкни копието.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
template.contentcontent е свойство само за четене на екземпляр на HTMLTemplateElement: то винаги връща един и същ DocumentFragment, но можеш да четеш и променяш възлите в него. Маркировката в обикновен елемент template се обработва като възли в този фрагмент, а не като деца на самия елемент. За да търсиш възли в съдържанието, използвай template.content.querySelector(...), а не template.querySelector(...).
В обикновен HTML документ ownerDocument на фрагмента сочи към отделен документ без контекст на браузване. Ако шаблонът вече принадлежи на документ, създаден за съхраняване на съдържание на шаблони, фрагментът използва същия документ. Дори да свържеш шаблона със страницата, съдържанието му не се показва и скриптовете, които още са във фрагмента, не се изпълняват. Неактивността не замества пречистването на HTML: ненадеждният HTML може да остане опасен след вмъкване. За обикновен текст използвай textContent.
За да запазиш шаблона за повторна употреба, извикай document.importNode(template.content, true) върху целевия документ, след което вмъкни копието. true копира и потомците; ако пропуснеш аргумента или подадеш false, получаваш празно копие на фрагмента. За разлика от cloneNode(true), импортирането използва контекста на целевия документ, което има значение за регистъра на потребителските елементи. Вмъкването на фрагмент премества децата му, а не самия фрагмент, който остава празен. Ако вмъкнеш оригинала, ще изпразниш шаблона.
Това е API на HTML DOM, а не част от ECMAScript 2024. Самата поддръжка на JavaScript не гарантира, че API е наличен.
Примери
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Template content example</title>
</head>
<body>
<script>
(() => {
const template = document.createElement('template');
const paragraph = document.createElement('p');
paragraph.textContent = 'Hello';
const original = template.content;
original.appendChild(paragraph);
const host = document.createElement('div');
host.appendChild(template);
document.body.appendChild(host);
const copy = document.importNode(original, true);
const inserted = copy.firstElementChild;
host.appendChild(copy);
console.log(`template children: ${template.childNodes.length}`);
console.log(`original children: ${original.childNodes.length}`);
console.log(`inserted: ${inserted.isConnected}, ${inserted.textContent}`);
console.log(`copy children: ${copy.childNodes.length}`);
host.remove();
})();
</script>
</body>
</html>Резултат
template children: 0 original children: 1 inserted: true, Hello copy children: 0
Отвори HTML файла в браузър и провери изхода в конзолата на инструментите за разработчици. Шаблонът няма преки деца, оригиналният фрагмент запазва абзаца си, вмъкнатото копие на абзаца е свързано с документа, а копираният фрагмент е празен.
Свързани уроци
- JavaScript · Урок 16 · Напреднало · Версия: 4