CKTIS / HTML
shadowrootmode — Shadow DOM declarativo
O atributo shadowrootmode de template permite ao analisador HTML criar uma raiz shadow declarativa. Os valores open e closed determinam o modo de acesso a essa raiz.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<template shadowrootmode="open|closed">…</template>shadowrootmode é um atributo enumerado de template, não um atributo booleano. Aceita open ou closed. A ausência do atributo, um valor vazio e um valor inválido correspondem todos ao estado None: por si só, o atributo não desencadeia então a criação de uma raiz shadow.
Durante a análise de um documento HTML, uma declaração válida cria uma raiz shadow no elemento pai, se este puder alojar Shadow DOM. O conteúdo da declaração passa para a raiz shadow, enquanto o próprio template não se torna um filho DOM do anfitrião. Se o anfitrião já tiver uma raiz shadow ou não for permitido anexar uma, o analisador deixa um template normal.
O modo open permite obter a raiz através de host.shadowRoot; no caso de closed, essa propriedade devolve null. Ambos os modos criam Shadow DOM — closed não significa que o conteúdo não será apresentado.
Este é um mecanismo do analisador, não um interruptor retroativo: adicionar shadowrootmode a um template existente não cria uma raiz shadow. Atribuir a marcação a innerHTML também não ativa o Shadow DOM declarativo. Abre o exemplo como um documento HTML, em vez de o inserir através de innerHTML.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Declarative shadow DOM</title>
<div id="host"><template shadowrootmode="open"><span>Hello</span></template></div>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
document.getElementById('result').textContent = [
host.shadowRoot.mode,
host.shadowRoot.querySelector('span').textContent,
String(host.querySelector('template'))
].join('\n');
</script>
</html>Resultado
open Hello null
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.