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

CKTIS / HTML

shadowrootclonable — клониране на декларативен shadow root

Булевият атрибут shadowrootclonable на елемент template обозначава декларативния shadow root като клонируем. Така при копиране на хост елемента може да бъде включено и неговото shadow дърво.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

<template shadowrootmode="open" shadowrootclonable>…</template>

shadowrootclonable е булев атрибут на template, който се използва заедно с shadowrootmode. При създаването на декларативен shadow root парсерът задава флага му за клонируемост според наличието на атрибута. Без него флагът е false; самият атрибут не създава shadow root.

Когато root е клонируем, host.cloneNode(true) копира и неговото shadow дърво. Това не е обичайното копиране на съдържанието на шаблона с template.content.cloneNode(true): копира се хостът с вече създадения му shadow root.

Наличието на атрибута включва опцията: shadowrootclonable="false" също я включва и не е валиден начин за изключване на булев атрибут. За да изключите тази опция в декларацията, пропуснете атрибута. shadowrootclonable не заменя shadowrootserializable: клонирането на възли и HTML сериализацията са отделни механизми.

Примерът изисква браузър, който поддържа декларативни shadow roots и този атрибут. Отворете целия HTML документ, вместо да вмъквате маркировката чрез innerHTML. Режимът open позволява проверка на копието чрез copy.shadowRoot; не е необходимо копираният хост да бъде добавен към документа.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Shadow root cloning</title>
<div id="host"><template shadowrootmode="open" shadowrootclonable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
  const host = document.getElementById('host');
  const copy = host.cloneNode(true);
  document.getElementById('result').textContent =
    copy.shadowRoot?.textContent ?? 'No shadow root';
</script>
</html>

Резултат

Hello

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

Източници