Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje