Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti