element.attachShadow

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

Syntax

var shadowroot = element.attachShadow(shadowRootInit); 

Parameters

shadowRootInit

A 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.
  It means elements of the shadow root are accessible from an outside world using element.shadowRoot
  

  element.shadowRoot === shadowroot; // returns true

• closed. Specifies closed encapsulation mode.
  This mode denies any access to node(s) of a closed shadow root from an outside world
  

  element.shadowRoot === shadowroot; // returns false
  element.shadowRoot === null; // returns true
  

Returns

Returns a ShadowRoot.

Specifications

Browser compatibility