Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

ShadowRoot — la racine d’un arbre Shadow DOM

ShadowRoot représente la racine d’un arbre Shadow DOM associé à un élément hôte. Il permet d’accéder à la structure interne d’un composant. Les modes open et closed diffèrent par l’accès via host.shadowRoot, mais aucun des deux ne constitue une frontière de sécurité.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

const root = host.attachShadow({ mode: "open" });
const sameRoot = host.shadowRoot;
root.append(document.createElement("span"));

ShadowRoot est la racine d’un arbre Shadow DOM, un DocumentFragment spécialisé associé à un élément hôte. Ses nœuds internes forment un arbre distinct : host.querySelector() ne les recherche pas, tandis que root.querySelector() effectue la recherche à l’intérieur. La propriété root.host désigne l’hôte.

Créez une racine avec host.attachShadow({ mode: "open" }), et non avec new ShadowRoot(). La méthode renvoie la racine ; en mode open, host.shadowRoot y donne également accès. En mode closed, cette propriété renvoie null, mais une référence conservée reste utilisable. Le mode closed limite l’accès via cette propriété ; il ne protège pas contre du code non fiable.

Shadow DOM permet l’encapsulation des composants, mais ne constitue ni un document distinct ni une isolation complète des styles : l’héritage CSS reste important. Un élément slot peut présenter les enfants de l’hôte sans les déplacer dans l’arbre shadow. Il n’est pas nécessaire d’enregistrer un élément personnalisé pour utiliser Shadow DOM sur un hôte pris en charge, tel que div.

Il s’agit d’une API de la plateforme Web, et non d’une fonctionnalité d’une édition particulière d’ECMAScript. La présence de Node 24 dans un dépôt ne prouve pas la prise en charge par les navigateurs. L’exemple nécessite un navigateur avec attachShadow et compare les deux modes sans modifier la page.

Exemples

(() => {
  const host = document.createElement("div");
  const root = host.attachShadow({ mode: "open" });
  const label = document.createElement("span");
  label.textContent = "Hello";
  root.append(label);

  console.log(root instanceof ShadowRoot);
  console.log(host.shadowRoot === root);
  console.log(root.host === host);
  console.log(root.querySelector("span").textContent);
  console.log(host.querySelector("span") === null);

  const closedHost = document.createElement("div");
  const closedRoot = closedHost.attachShadow({ mode: "closed" });
  console.log(closedHost.shadowRoot === null);
  console.log(closedRoot.host === closedHost);
})();

Résultat

true
true
true
Hello
true
true
true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources