Element.attachShadow()

This article needs a technical review. How you can help.

 

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.

The Element.attachShadow() method attatches a shadow DOM tree to the specified element and returns a reference to its ShadowRoot.

Syntax

var shadowroot = element.attachShadow(shadowRootInit); 

Parameters

shadowRootInit
ShadowRootInit dictionary, having the following field:
  • mode: A string specifying the encapsulation mode for the shadow DOM tree. One of:
    • open. Specifies open encapsulation mode.
    • closed. Specifies closed encapsulation mode.

Returns

Returns a ShadowRoot.

Specifications

Specification Status Comment
Shadow DOM
The definition of 'attachShadow()' in that specification.
Working Draft Initial definition.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 53.0 No support No support ? 10.0
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support 53.0 No support ? ? ? ? 53.0

Document Tags and Contributors

 Contributors to this page: fleurdeswift, jpmedley, jwhitlock, tomfun, rolfedh, arthurevans
 Last updated by: fleurdeswift,