CKTIS / HTML
shadowrootmode — декларативен Shadow DOM
Атрибутът shadowrootmode на template позволява на HTML парсера да създаде декларативен shadow root. Стойностите open и closed определят режима на достъп до този root.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<template shadowrootmode="open|closed">…</template>shadowrootmode е изброим атрибут на template, а не булев атрибут. Приема open или closed. Липсващ атрибут, празна стойност и невалидна стойност означават състояние None: сам по себе си атрибутът не задейства създаване на shadow root.
При парсване на HTML документ валидна декларация създава shadow root върху родителския елемент, ако той може да бъде хост за Shadow DOM. Съдържанието на декларацията влиза в shadow root, а самият template не става DOM дете на хоста. Ако хостът вече има shadow root или добавянето на такъв не е разрешено, парсерът оставя обикновен template.
Режимът open позволява извличане на root чрез host.shadowRoot; при closed това свойство връща null. И двата режима създават Shadow DOM — closed не означава, че съдържанието няма да се визуализира.
Това е механизъм на парсера, а не превключвател с обратно действие: добавянето на shadowrootmode към съществуващ template не създава shadow root. Задаването на маркировката в innerHTML също не активира декларативен Shadow DOM. Отворете примера като HTML документ, вместо да го вмъквате чрез innerHTML.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Declarative shadow DOM</title>
<div id="host"><template shadowrootmode="open"><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
document.getElementById('result').textContent = [
host.shadowRoot.mode,
host.shadowRoot.querySelector('span').textContent,
String(host.querySelector('template'))
].join('\n');
</script>
</html>Резултат
open Hello null
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.