diff --git a/index.html b/index.html index d86da6a..89c9fec 100644 --- a/index.html +++ b/index.html @@ -118,7 +118,7 @@

Extensibility

This specification concerns itself with defining various APIs for both parsing and serializing a DOM. -
For example: the innerHTML API is a common way to both +
For example: the innerHTML API is a common way to both parse and serialize a DOM (it does both). If a particular Node, has the following in-memory DOM: 
@@ -134,7 +134,7 @@ 
Extensibility
And the HTMLDivElement node is stored in a variable myDiv, then to serialize myDiv's children simply get (read) the - Element's innerHTML property (this triggers the serialization): + Element's innerHTML property (this triggers the serialization): 
     var serializedChildren = myDiv.innerHTML;
@@ -143,7 +143,7 @@ 
Extensibility

To parse new children for myDiv from a string (replacing its existing - children), simply set the innerHTML property (this triggers + children), simply set the innerHTML property (this triggers parsing of the assigned string): 

@@ -221,10 +221,10 @@ 
Extensibility
-
domparser = new DOMParser () +
domparser = new DOMParser ()
Constructs a new DOMParser object. -
document = domparser . parseFromString ( str, type ) +
document = domparser . parseFromString ( str, type )
Parse str using a parser that matches type's supported MIME types (either XML or HTML), and return a Document object contained the parsed content if successful. If not successful, returns a Document describing the error. @@ -235,11 +235,11 @@

Extensibility

The DOMParser constructor must return a new DOMParser object.

The - parseFromString(str, type) + parseFromString(str, type) method must run these steps, depending on type:

-
"text/html" +
"text/html"
Parse str with an HTML parser, and return the newly created Document. @@ -250,10 +250,10 @@

Extensibility

script elements get marked unexecutable and the contents of noscript get parsed as markup. -

"text/xml" -
"application/xml" -
"application/xhtml+xml" -
"image/svg+xml" +
"text/xml" +
"application/xml" +
"application/xhtml+xml" +
"image/svg+xml"
  1. Parse str with a namespace-enabled XML parser. @@ -299,10 +299,10 @@

    Extensibility

    -
    xmlserializer = new XMLSerializer () +
    xmlserializer = new XMLSerializer ()
    Constructs a new XMLSerializer object. -
    string = xmlserializer . serializeToString ( root ) +
    string = xmlserializer . serializeToString ( root )
    Serializes root into a string using an XML serialization. Throws a TypeError exception if root is not a Node or an Attr object.
    @@ -310,7 +310,7 @@

    Extensibility

    The XMLSerializer() constructor must return a new XMLSerializer object. -

    The serializeToString(root) method must +

    The serializeToString(root) method must produce an XML serialization of root passing a value of false for the require well-formed parameter, and return the result. @@ -328,11 +328,11 @@

    Extensibility

    -

    The innerHTML IDL attribute represents the markup of the +

    The innerHTML IDL attribute represents the markup of the Element's contents.

    -
    element . innerHTML [ = value ] +
    element . innerHTML [ = value ]
    Returns a fragment of HTML or XML that represents the element's contents.

    Can be set, to replace the contents of the element with nodes parsed from the given string. @@ -358,7 +358,7 @@

    Extensibility

    context object be the template's template contents (a DocumentFragment). -

    Setting innerHTML on a template element will replace +

    Setting innerHTML on a template element will replace all the nodes in its template contents (template.content) rather than its children.

    @@ -367,11 +367,11 @@

    Extensibility

    -

    The outerHTML IDL attribute represents the markup of the +

    The outerHTML IDL attribute represents the markup of the Element and its contents.

    -
    element . outerHTML [ = value ] +
    element . outerHTML [ = value ]
    Returns a fragment of HTML or XML that represents the element and its contents.

    Can be set, to replace the element with nodes parsed from the given string. @@ -421,7 +421,7 @@

    Extensibility

    -
    element . insertAdjacentHTML ( position, text ) +
    element . insertAdjacentHTML ( position, text )
    Parses the given string text as HTML or XML and inserts the resulting nodes into the tree in the position given by the position argument, as follows: @@ -449,7 +449,7 @@

    Extensibility

    The - insertAdjacentHTML(position, text) + insertAdjacentHTML(position, text) method must run these steps:

      @@ -524,10 +524,10 @@

      Extensibility

      No special handling for template elements is included in the above "afterbegin" and "beforeend" cases. As with other direct - Node-manipulation APIs (and unlike innerHTML), - insertAdjacentHTML does not include any special handling for + Node-manipulation APIs (and unlike innerHTML), + insertAdjacentHTML does not include any special handling for template elements. In most cases you will wish to use - template.content.insertAdjacentHTML + template.content.insertAdjacentHTML instead of directly manipulating the child nodes of a template element.

      @@ -542,13 +542,13 @@

      Extensibility

      -
      docFragment = range . createContextualFragment ( fragment ) +
      docFragment = range . createContextualFragment ( fragment )
      Returns a DocumentFragment, created from the markup string fragment using range's start node as the context in which fragment is parsed.
      -

      The createContextualFragment(fragment) method +

      The createContextualFragment(fragment) method must run these steps:

        @@ -566,7 +566,7 @@

        Extensibility

        Text
        Comment -
        node's parent element +
        node's parent element
        DocumentType
        ProcessingInstruction @@ -617,20 +617,20 @@

        Extensibility

        -
        text . serializeAsCDATA [ = value ] +
        text . serializeAsCDATA [ = value ]
        Controls whether, in XML, this node is serialized as a CDATA section.

        Text nodes have an additional associated flag, the serialize as CDATA flag. -

        The serializeAsCDATA attribute must return true if the +

        The serializeAsCDATA attribute must return true if the context object has its serialize as CDATA flag set, or false otherwise. -

        Setting the serializeAsCDATA attribute must, if the new value is true, set +

        Setting the serializeAsCDATA attribute must, if the new value is true, set the context object's serialize as CDATA flag, or unset it otherwise. - +--> @@ -1848,8 +1848,8 @@

        Acknowledgements

        and Boris Zbarsky, for their useful comments. -

        Special thanks to Ian Hickson for first defining the innerHTML and outerHTML - attributes, and the insertAdjacentHTML method in [[HTML5]] and his useful comments. +

        Special thanks to Ian Hickson for first defining the innerHTML and outerHTML + attributes, and the insertAdjacentHTML method in [[HTML5]] and his useful comments. diff --git a/respecConfig.js b/respecConfig.js index 9588e84..a054135 100644 --- a/respecConfig.js +++ b/respecConfig.js @@ -10,10 +10,10 @@ var respecConfig = { //format: "markdown", shortName: "DOM-Parsing", wg: ["Web Platform Working Group"], - wgURI: ["http://www.w3.org/WebPlatform/WG/"], + wgURI: ["https://www.w3.org/WebPlatform/WG/"], license: "w3c-software-doc", wgPublicList: "www-dom", - wgPatentURI: ["http://www.w3.org/2004/01/pp-impl/83482/status"], + wgPatentURI: ["https://www.w3.org/2004/01/pp-impl/83482/status"], subjectPrefix: "DOM-Parsing", otherLinks: [{ key: "Test Suites", data: [