CKTIS / HTML
shadowrootclonable — klonovanie deklaratívneho koreňa tieňa
Logický atribút shadowrootclonable na prvku template označuje deklaratívny koreň tieňa ako klonovateľný. Kopírovanie hostiteľského prvku potom môže zahrnúť aj jeho strom tieňa.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootclonable>…</template>shadowrootclonable je logický atribút prvku template, ktorý sa používa spolu s shadowrootmode. Pri vytváraní deklaratívneho koreňa tieňa nastaví parser jeho príznak klonovateľnosti podľa prítomnosti atribútu. Bez neho je príznak false; samotný atribút koreň tieňa nevytvorí.
Ak je koreň klonovateľný, host.cloneNode(true) skopíruje aj jeho strom tieňa. Nejde o bežné kopírovanie obsahu šablóny pomocou template.content.cloneNode(true): kopíruje sa hostiteľ s už vytvoreným koreňom tieňa.
Prítomnosť atribútu túto možnosť zapína: shadowrootclonable="false" ju zapína tiež a nie je platným spôsobom, ako vypnúť logický atribút. Ak chcete túto možnosť v deklarácii vypnúť, atribút vynechajte. shadowrootclonable nenahrádza shadowrootserializable: klonovanie uzlov a serializácia HTML sú samostatné mechanizmy.
Príklad vyžaduje prehliadač podporujúci deklaratívne korene tieňa a tento atribút. Otvorte celý dokument HTML namiesto vkladania značiek cez innerHTML. Režim open umožňuje skontrolovať kópiu pomocou copy.shadowRoot; skopírovaného hostiteľa netreba pripojiť k dokumentu.
Prí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ýsledok
Hello
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.