Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

shadowrootclonable — clonar uma raiz shadow declarativa

O atributo booleano shadowrootclonable de um elemento template marca uma raiz shadow declarativa como clonável. Assim, ao copiar o elemento anfitrião, também é possível incluir a respetiva árvore shadow.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<template shadowrootmode="open" shadowrootclonable>…</template>

shadowrootclonable é um atributo booleano de template, usado com shadowrootmode. Ao criar uma raiz shadow declarativa, o analisador define o respetivo indicador de clonagem com base na presença do atributo. Sem o atributo, o indicador é false; o atributo, por si só, não cria uma raiz shadow.

Quando a raiz é clonável, host.cloneNode(true) também copia a respetiva árvore shadow. Isto não é o mesmo que copiar normalmente o conteúdo do modelo com template.content.cloneNode(true): copia-se o anfitrião com a raiz shadow que já foi criada.

A presença ativa a opção: shadowrootclonable="false" também a ativa e não é uma forma válida de desativar um atributo booleano. Para desativar esta opção na declaração, omita o atributo. shadowrootclonable não substitui shadowrootserializable: a clonagem de nós e a serialização HTML são mecanismos distintos.

O exemplo requer um navegador compatível com raízes shadow declarativas e com este atributo. Abra o documento HTML completo, em vez de inserir a marcação através de innerHTML. O modo open permite inspecionar a cópia através de copy.shadowRoot; não é necessário anexar o anfitrião copiado ao documento.

Exemplos

<!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>

Resultado

Hello

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes