diff --git a/dom.bs b/dom.bs index 08686e39b..6b3b78da9 100644 --- a/dom.bs +++ b/dom.bs @@ -1450,6 +1450,11 @@ A node is considered

A shadow tree is a node tree whose root is a shadow root. +

A shadow root is always connected to another node tree through its +host. A shadow tree is therefore never alone. The +node tree of a shadow root's host is sometimes +referred to as the light tree.

+

Mutation algorithms

@@ -4975,13 +4980,14 @@ interface DocumentFragment : Node { }; -

A {{DocumentFragment}} node can have an associated element named -host. +

A {{DocumentFragment}} node has an associated +host (null or an +element in a different node tree). It is null unless otherwise stated.

An object A is a host-including inclusive ancestor of an object B, if either A is an inclusive ancestor of B, -or if B's root has an associated host and +or if B's root has a non-null host and A is a host-including inclusive ancestor of B's root's host. @@ -5014,6 +5020,10 @@ interface ShadowRoot : DocumentFragment {

Shadow roots have an associated encapsulation mode ("open" or "closed").

+

Shadow roots's associated host is never null.

+ +

The host attribute's getter must return the context object's host. diff --git a/dom.html b/dom.html index 62b9e9771..5c7706ce1 100644 --- a/dom.html +++ b/dom.html @@ -1023,6 +1023,8 @@

4.2.2. Shadow tree

A shadow tree is a node tree whose root is a shadow root.

+

A shadow root is always connected to another node tree through its host. A shadow tree is therefore never alone. The node tree of a shadow root’s host is sometimes +referred to as the light tree.

4.2.3. Mutation algorithms

To ensure pre-insertion validity of a node into a parent before a child, run these steps:

    @@ -2768,9 +2770,9 @@

    DocumentFragment : Node { }; -

    A DocumentFragment node can have an associated element named host.

    +

    A DocumentFragment node has an associated host (null or an element in a different node tree). It is null unless otherwise stated.

    An object A is a host-including inclusive ancestor of an object B, if either A is an inclusive ancestor of B, -or if B’s root has an associated host and A is a host-including inclusive ancestor of B’s root’s host.

    +or if B’s root has a non-null host and A is a host-including inclusive ancestor of B’s root’s host.

    The DocumentFragment node’s host concept is useful for HTML’s template element and for shadow roots, and impacts the pre-insert and replace algorithms.

    tree = new DocumentFragment() @@ -2787,6 +2789,7 @@

    ShadowRoot nodes are simply known as shadow roots.

    Shadow roots have an associated encapsulation mode ("open" or "closed").

    +

    Shadow roots’s associated host is never null.

    The host attribute’s getter must return the context object’s host.


    In shadow-including tree order, is shadow-including preorder, depth-first traversal of a node tree. shadow-including preorder, depth-first traversal of a node tree tree is preorder, depth-first traversal of tree, with for each element element encountered in tree with a non-null shadow root, shadow-including preorder, depth-first traversal of that element’s shadow root’s node tree just after it is @@ -5193,6 +5196,7 @@

    attribute for CharacterData, in §4.10
  1. attribute for DOMTokenList, in §7.1 +
  2. light tree, in §4.2.2
  3. limited-quirks mode, in §4.5
  4. list of elements with class names classNames, in §4.4
  5. list of elements with namespace