Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

shadowrootmode — Shadow DOM dichiarativo

L’attributo shadowrootmode di template permette al parser HTML di creare una radice shadow dichiarativa. I valori open e closed determinano la modalità di accesso a tale radice.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<template shadowrootmode="open|closed">…</template>

shadowrootmode è un attributo enumerato di template, non un attributo booleano. Accetta open o closed. L’assenza dell’attributo, un valore vuoto e un valore non valido indicano tutti lo stato None: da solo, l’attributo non attiva quindi la creazione di una radice shadow.

Durante l’analisi di un documento HTML, una dichiarazione valida crea una radice shadow sull’elemento genitore, se può ospitare Shadow DOM. Il contenuto della dichiarazione entra nella radice shadow, mentre il template stesso non diventa un figlio DOM dell’host. Se l’host ha già una radice shadow o non è consentito aggiungerne una, il parser lascia un normale template.

La modalità open permette di recuperare la radice tramite host.shadowRoot; con closed, tale proprietà restituisce null. Entrambe le modalità creano Shadow DOM: closed non significa che il contenuto non verrà visualizzato.

Questo è un meccanismo del parser, non un interruttore retroattivo: aggiungere shadowrootmode a un template esistente non crea una radice shadow. Anche assegnare il markup a innerHTML non attiva lo Shadow DOM dichiarativo. Apri l’esempio come documento HTML, invece di inserirlo tramite innerHTML.

Esempi

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

Risultato

open
Hello
null

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