CKTIS / HTML
shadowrootclonable — klonování deklarativního kořene stínu
Logický atribut shadowrootclonable na prvku template označuje deklarativní kořen stínu jako klonovatelný. Kopírování hostitelského prvku pak může zahrnout i jeho strom stínu.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template shadowrootmode="open" shadowrootclonable>…</template>shadowrootclonable je logický atribut prvku template, který se používá společně s shadowrootmode. Při vytváření deklarativního kořene stínu nastaví parser jeho příznak klonovatelnosti podle přítomnosti atributu. Bez něj je příznak false; samotný atribut kořen stínu nevytvoří.
Je-li kořen klonovatelný, host.cloneNode(true) zkopíruje také jeho strom stínu. Nejde o běžné kopírování obsahu šablony pomocí template.content.cloneNode(true): kopíruje se hostitel s již vytvořeným kořenem stínu.
Přítomnost atributu tuto možnost zapíná: shadowrootclonable="false" ji zapíná také a není platným způsobem, jak logický atribut vypnout. Chcete-li tuto možnost v deklaraci vypnout, atribut vynechte. shadowrootclonable nenahrazuje shadowrootserializable: klonování uzlů a serializace HTML jsou samostatné mechanismy.
Příklad vyžaduje prohlížeč podporující deklarativní kořeny stínu a tento atribut. Otevřete celý dokument HTML, místo abyste značky vkládali přes innerHTML. Režim open umožňuje zkontrolovat kopii pomocí copy.shadowRoot; zkopírovaného hostitele není třeba připojit k dokumentu.
Příklady
<!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>Výsledek
Hello
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.