Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Element.attachShadow()

Baseline Widely available *

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨janvier 2020⁩.

* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

La méthode Element.attachShadow() attache un arbre Shadow DOM à un élément spécifié et retourne une référence à son ShadowRoot.

Syntaxe

js
var shadowroot = element.attachShadow(shadowRootInit);

Paramètres

shadowRootInit

Un dictionnaire ShadowRootInit, avec les propriétés suivantes :

  • mode : une chaîne de caractères spécifiant le mode d'encapsulation de l'arbre du Shadow DOM, parmi les options suivantes :
    • open : spécifie une encapsulation ouverte.
    • closed : spécifie une encapsulation fermée.

Retour

Retourne un ShadowRoot.

Spécifications

Specification
DOM
# dom-element-attachshadow

Compatibilité des navigateurs