From 443023ad7e5a04d050e21a206aff1b5bd66ddc07 Mon Sep 17 00:00:00 2001 From: Anne van Kesteren Date: Tue, 16 Aug 2016 14:38:38 +0200 Subject: [PATCH] Editorial: stop enumerating ShadowRoot alongside DocumentFragment MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit We don’t mention other concrete subclasses either, such as HTMLBodyElement. So the new policy is to list concrete classes (DocumentFragment) unless they’re a subclass of a concrete class (ShadowRoot) and not list abstract classes (CharacterData). Fixes #190. --- dom.bs | 16 ++++------------ dom.html | 14 +++----------- 2 files changed, 7 insertions(+), 23 deletions(-) diff --git a/dom.bs b/dom.bs index 534947b69..33b45dcbd 100644 --- a/dom.bs +++ b/dom.bs @@ -1488,7 +1488,7 @@ can be used to explore this matter in more detail.

Node tree

-

{{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{ShadowRoot}}, {{Element}}, {{Text}}, +

{{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}}, {{Text}}, {{ProcessingInstruction}}, and {{Comment}} objects (simply called nodes) participate in a tree, simply named the node tree. @@ -1508,7 +1508,6 @@ can be used to explore this matter in more detail.

  • Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.

    {{DocumentFragment}} -
    {{ShadowRoot}}
    {{Element}}

    Zero or more nodes each of which is {{Element}}, {{Text}}, {{ProcessingInstruction}}, or {{Comment}}. @@ -3460,8 +3459,8 @@ dictionary GetRootNodeOptions {

    {{Node}} is an abstract interface and does not exist as node. It -is used by all nodes ({{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{ShadowRoot}}, -{{Element}}, {{Text}}, {{ProcessingInstruction}}, and {{Comment}}). +is used by all nodes ({{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}}, +{{Text}}, {{ProcessingInstruction}}, and {{Comment}}). Each node has an associated node document, set upon creation, @@ -3507,7 +3506,7 @@ that is a document. doctype.

    {{Node}} . {{Node/DOCUMENT_FRAGMENT_NODE}} (11) -
    node is a {{DocumentFragment}} or {{ShadowRoot}} node. +
    node is a {{DocumentFragment}} node.
    node . {{Node/nodeName}} @@ -3535,7 +3534,6 @@ that is a document.
    Its name.
    {{DocumentFragment}} -
    {{ShadowRoot}}
    "#document-fragment". @@ -3572,7 +3570,6 @@ the first matching statement, switching on the context object:
    DOCUMENT_TYPE_NODE (10);
    {{DocumentFragment}} -
    {{ShadowRoot}}
    DOCUMENT_FRAGMENT_NODE (11). @@ -3633,7 +3630,6 @@ the first matching statement, switching on the context object:
    Its name.
    {{DocumentFragment}} -
    {{ShadowRoot}}
    "#document-fragment". @@ -3785,7 +3781,6 @@ following, switching on context object:
    {{DocumentFragment}} -
    {{ShadowRoot}}
    {{Element}}
    The concatenation of data of all @@ -3809,7 +3804,6 @@ the empty string instead, and then do as described below, switching on contex
    {{DocumentFragment}} -
    {{ShadowRoot}}
    {{Element}}
    @@ -4320,7 +4314,6 @@ To locate a namespace for a node using
    {{DocumentType}}
    {{DocumentFragment}} -
    {{ShadowRoot}}
    Return null.
    Any other node @@ -4358,7 +4351,6 @@ method must run these steps:
    {{DocumentType}}
    {{DocumentFragment}} -
    {{ShadowRoot}}
    Return null.
    Any other node diff --git a/dom.html b/dom.html index 5623657f8..82b8040ac 100644 --- a/dom.html +++ b/dom.html @@ -1082,7 +1082,7 @@

    tree of nodes comes out.

    The most excellent Live DOM Viewer can be used to explore this matter in more detail.

    4.2. Node tree

    -

    Document, DocumentType, DocumentFragment, ShadowRoot, Element, Text, ProcessingInstruction, and Comment objects (simply called nodes) participate in a tree, simply named the node tree.

    +

    Document, DocumentType, DocumentFragment, Element, Text, ProcessingInstruction, and Comment objects (simply called nodes) participate in a tree, simply named the node tree.

    A node tree is constrained as follows, expressed as a relationship between the type of node and its allowed children:

    Document @@ -1101,7 +1101,6 @@

    Zero or more nodes each of which is ProcessingInstruction or Comment.

    DocumentFragment -
    ShadowRoot
    Element

    Zero or more nodes each of which is Element, Text, ProcessingInstruction, or Comment.

    @@ -2126,7 +2125,7 @@

    Node is an abstract interface and does not exist as node. It -is used by all nodes (Document, DocumentType, DocumentFragment, ShadowRoot, Element, Text, ProcessingInstruction, and Comment).

    +is used by all nodes (Document, DocumentType, DocumentFragment, Element, Text, ProcessingInstruction, and Comment).

    Each node has an associated node document, set upon creation, that is a document.

    A node’s node document can be changed by the adopt algorithm.

    @@ -2150,7 +2149,7 @@

    Node . DOCUMENT_TYPE_NODE (10)
    node is a doctype.
    Node . DOCUMENT_FRAGMENT_NODE (11) -
    node is a DocumentFragment or ShadowRoot node. +
    node is a DocumentFragment node.

    node . nodeName
    @@ -2170,7 +2169,6 @@

    DocumentType
    Its name.
    DocumentFragment -
    ShadowRoot
    "#document-fragment".

    @@ -2190,7 +2188,6 @@

    DocumentType
    DOCUMENT_TYPE_NODE (10);
    DocumentFragment -
    ShadowRoot
    DOCUMENT_FRAGMENT_NODE (11).

    The nodeName attribute’s getter, when invoked, must return @@ -2209,7 +2206,6 @@

    DocumentType
    Its name.
    DocumentFragment -
    ShadowRoot
    "#document-fragment".
    @@ -2289,7 +2285,6 @@

    context object:

    DocumentFragment -
    ShadowRoot
    Element
    The concatenation of data of all the Text node descendants of the context object, in tree order. @@ -2304,7 +2299,6 @@

    context object:

    DocumentFragment -
    ShadowRoot
    Element
      @@ -2539,7 +2533,6 @@

      DocumentType
      DocumentFragment -
      ShadowRoot
      Return null.
      Any other node
      @@ -2562,7 +2555,6 @@

      DocumentType
      DocumentFragment -
      ShadowRoot
      Return null.
      Any other node
      Return the result of locating a namespace prefix for its parent element, or if that is null, null.