CKTIS / HTML
shadowrootserializable — сериализиране на декларативен shadow root
Булевият атрибут shadowrootserializable маркира декларативен shadow root за сериализиране чрез getHTML({ serializableShadowRoots: true }). Той не го включва автоматично в обичайния резултат от getHTML() или в innerHTML на хоста.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable е булев атрибут на елемента template. Когато парсерът създаде декларативен shadow root от shadowrootmode="open" или shadowrootmode="closed", наличието на този атрибут задава флага му за сериализиране. Сам по себе си shadowrootserializable, без валиден shadowrootmode, не създава shadow root. За да изключите тази опция, пропуснете атрибута; shadowrootserializable="false" също се счита за наличен.
Извикването host.getHTML({ serializableShadowRoots: true }) включва маркирания shadow root като декларативна маркировка template заедно със съдържанието му. Обичайното host.getHTML() и прочитането на host.innerHTML пропускат shadow root на хоста. Опцията shadowRoots на getHTML() ви позволява изрично да изберете корени за сериализиране независимо от флага им за сериализиране.
Сериализирането не е клониране: shadowrootserializable не заменя shadowrootclonable. То не е и механизъм за защита на данни. Маркиран root в режим closed също може да се появи при сериализирането на хоста. Затова не съхранявайте тайни в него с предположението, че този режим предотвратява изнасянето им.
Заредете примера като HTML документ, за да създаде парсерът декларативния shadow root. Задаването на същата маркировка на innerHTML няма да го създаде. Трите проверки показват, че rootът обичайно се пропуска и че атрибутът и съдържанието му присъстват при включено сериализиране.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>shadowrootserializable</title>
<div id="host"><template shadowrootmode="open" shadowrootserializable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
const html = host.getHTML({ serializableShadowRoots: true });
document.getElementById('result').textContent = [
host.getHTML() === '',
html.includes('shadowrootserializable=""'),
html.includes('<span>Hello</span>')
].join('\n');
</script>
</html>Резултат
true true true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.