CKTIS / HTML
shadowrootclonable — clonare una radice shadow dichiarativa
L’attributo booleano shadowrootclonable di un elemento template indica che una radice shadow dichiarativa è clonabile. In questo modo, copiando l’elemento host si può includere anche il relativo albero shadow.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<template shadowrootmode="open" shadowrootclonable>…</template>shadowrootclonable è un attributo booleano di template, usato insieme a shadowrootmode. Quando crea una radice shadow dichiarativa, il parser imposta il relativo flag di clonabilità in base alla presenza dell’attributo. Se l’attributo è assente, il flag è false; l’attributo da solo non crea una radice shadow.
Se la radice è clonabile, host.cloneNode(true) copia anche il suo albero shadow. Non si tratta della normale copia del contenuto del template con template.content.cloneNode(true): viene copiato l’host con la radice shadow già creata.
La presenza attiva l’opzione: anche shadowrootclonable="false" la attiva e non è un modo valido per disabilitare un attributo booleano. Per disattivare l’opzione nella dichiarazione, ometti l’attributo. shadowrootclonable non sostituisce shadowrootserializable: la clonazione dei nodi e la serializzazione HTML sono meccanismi distinti.
L’esempio richiede un browser che supporti le radici shadow dichiarative e questo attributo. Apri il documento HTML completo invece di inserire il markup tramite innerHTML. La modalità open consente di ispezionare la copia con copy.shadowRoot; non è necessario aggiungere al documento l’host copiato.
Esempi
<!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>Risultato
Hello
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.