CKTIS / HTML
shadowrootserializable — serializar uma raiz shadow declarativa
O atributo booleano shadowrootserializable assinala uma raiz shadow declarativa para serialização através de getHTML({ serializableShadowRoots: true }). Não a inclui automaticamente no resultado habitual de getHTML() nem no innerHTML do anfitrião.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<template shadowrootmode="open" shadowrootserializable>…</template>shadowrootserializable é um atributo booleano do elemento template. Quando o analisador cria uma raiz shadow declarativa a partir de shadowrootmode="open" ou shadowrootmode="closed", a presença deste atributo ativa o respetivo indicador de serialização. shadowrootserializable por si só, sem um shadowrootmode válido, não cria uma raiz shadow. Para desativar a opção, omite o atributo; shadowrootserializable="false" também conta como presente.
A chamada host.getHTML({ serializableShadowRoots: true }) inclui a raiz shadow assinalada como marcação declarativa template, com o respetivo conteúdo. A chamada habitual host.getHTML() e a leitura de host.innerHTML omitem a raiz shadow do anfitrião. A opção shadowRoots de getHTML() permite selecionar explicitamente as raízes a serializar, independentemente do respetivo indicador de serialização.
A serialização não é clonagem: shadowrootserializable não substitui shadowrootclonable. Também não é um mecanismo de proteção de dados. Uma raiz assinalada no modo closed pode surgir na serialização do respetivo anfitrião. Por isso, não guardes segredos nessa raiz supondo que esse modo impede a sua exportação.
Carrega o exemplo como documento HTML para que o analisador crie a raiz shadow declarativa. Atribuir a mesma marcação a innerHTML não a criará. As três verificações mostram que a raiz é omitida por predefinição e que o respetivo atributo e conteúdo estão presentes quando a serialização é ativada.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>shadowrootserializable</title>
<div id="host"><template shadowrootmode="open" shadowrootserializable><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
const html = host.getHTML({ serializableShadowRoots: true });
document.getElementById('result').textContent = [
host.getHTML() === '',
html.includes('shadowrootserializable=""'),
html.includes('<span>Hello</span>')
].join('\n');
</script>
</html>Resultado
true true true
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.