Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje