Look up a custom element registry can be given a DocumentFragment

Slightly modernize "create an element for the token" while here (#1706 remains).

Fixes #11227.

Author: annevk

source

@@ -73754,8 +73754,8 @@ dictionary <dfn dictionary>ElementDefinitionOptions</dfn> {
   element names</span> to promises. It is used to implement the <code
   data-x="dom-CustomElementRegistry-whenDefined">whenDefined()</code> method.</p>
 
-  <p>To <dfn export>look up a custom element registry</dfn>, given an <code>Element</code> object,
-  <code>ShadowRoot</code> object, or <code>Document</code> object <var>node</var>:</p>
+  <p>To <dfn export>look up a custom element registry</dfn>, given a <code>Node</code> object
+  <var>node</var>:</p>
 
   <ol>
    <li><p>If <var>node</var> is an <code>Element</code> object, then return <var>node</var>'s <span
@@ -73764,8 +73764,10 @@ dictionary <dfn dictionary>ElementDefinitionOptions</dfn> {
    <li><p>If <var>node</var> is a <code>ShadowRoot</code> object, then return <var>node</var>'s
    <span data-x="shadow-root-custom-element-registry">custom element registry</span>.</p></li>
 
-   <li><p>Return <var>node</var>'s <span data-x="document-custom-element-registry">custom element
-   registry</span>.</p></li>
+   <li><p>If <var>node</var> is a <code>Document</code> object, then return <var>node</var>'s <span
+   data-x="document-custom-element-registry">custom element registry</span>.</p></li>
+
+   <li><p>Return null.</p></li>
   </ol>
 
   </div>
@@ -130839,39 +130841,39 @@ dictionary <dfn dictionary>StorageEventInit</dfn> : <span>EventInit</span> {
 
   <hr>
 
-  <p>When the steps below require the UA to <dfn data-x="create an element for the token">create an
-  element for a token</dfn> in a particular <var>given namespace</var> and with a
-  particular <var>intended parent</var>, the UA must run the following steps:</p>
+  <p>To <dfn data-x="create an element for the token">create an element for a token</dfn>, given a
+  token <var>token</var>, a string <var>namespace</var> and a <code>Node</code> object
+  <var>intendedParent</var>:</p>
 
   <ol>
    <li><p>If the <span>active speculative HTML parser</span> is not null, then return the result of
    <span data-x="create a speculative mock element">creating a speculative mock element</span>
-   given <var>given namespace</var>, the tag name of the given token, and the attributes of the
-   given token.</p></li>
+   given <var>namespace</var>, <var>token</var>'s tag name, and <var>token</var>'s
+   attributes.</p></li>
 
    <li>
-    <p>Otherwise, optionally <span>create a speculative mock element</span> given <var>given
-    namespace</var>, the tag name of the given token, and the attributes of the given token.</p>
+    <p>Otherwise, optionally <span>create a speculative mock element</span> given
+    <var>namespace</var>, <var>token</var>'s tag name, and <var>token</var>'s attributes.</p>
 
     <p class="note">The result is not used. This step allows for a <span>speculative fetch</span> to
     be initiated from non-speculative parsing. The fetch is still speculative at this point,
     because, for example, by the time the element is inserted, <var>intended parent</var> might
     have been removed from the document.</p>
    </li>
 
-   <li><p>Let <var>document</var> be <var>intended parent</var>'s <span>node document</span>.</li>
+   <li><p>Let <var>document</var> be <var>intendedParent</var>'s <span>node document</span>.</li>
 
-   <li><p>Let <var>local name</var> be the tag name of the token.</p></li>
+   <li><p>Let <var>localName</var> be <var>token</var>'s tag name.</p></li>
 
-   <li><p>Let <var>is</var> be the value of the "<code data-x="attr-is">is</code>" attribute in the
-   given token, if such an attribute exists, or null otherwise.</p></li>
+   <li><p>Let <var>is</var> be the value of the "<code data-x="attr-is">is</code>" attribute in
+   <var>token</var>, if such an attribute exists; otherwise null.</p></li>
 
    <li><p>Let <var>registry</var> be the result of <span data-x="look up a custom element
-   registry">looking up a custom element registry</span> given <var>intended parent</var>.</p></li>
+   registry">looking up a custom element registry</span> given <var>intendedParent</var>.</p></li>
 
    <li><p>Let <var>definition</var> be the result of <span data-x="look up a custom element
-   definition">looking up a custom element definition</span> given <var>registry</var>, <var>given
-   namespace</var>, <var>local name</var>, and <var>is</var>.</p></li>
+   definition">looking up a custom element definition</span> given <var>registry</var>,
+   <var>namespace</var>, <var>localName</var>, and <var>is</var>.</p></li>
 
    <li><p>Let <var>willExecuteScript</var> be true if <var>definition</var> is non-null and the
    parser was not created as part of the <span>HTML fragment parsing algorithm</span>; otherwise
@@ -130894,8 +130896,8 @@ dictionary <dfn dictionary>StorageEventInit</dfn> : <span>EventInit</span> {
 
    <li>
     <p>Let <var>element</var> be the result of <span data-x="create an element">creating an
-    element</span> given <var>document</var>, <var>localName</var>, <var>given namespace</var>,
-    null, <var>is</var>, <var>willExecuteScript</var>, and <var>registry</var>.</p>
+    element</span> given <var>document</var>, <var>localName</var>, <var>namespace</var>, null,
+    <var>is</var>, <var>willExecuteScript</var>, and <var>registry</var>.</p>
 
     <p class="note">This will cause <span data-x="custom element constructor">custom element
     constructors</span> to run, if <var>willExecuteScript</var> is true. However, since we
@@ -130950,7 +130952,7 @@ dictionary <dfn dictionary>StorageEventInit</dfn> : <span>EventInit</span> {
    <span><code data-x="">form</code> element pointer</span> is not null, there is no
    <code>template</code> element on the <span>stack of open elements</span>, <var>element</var> is
    either not <span data-x="category-listed">listed</span> or doesn't have a <code
-   data-x="attr-fae-form">form</code> attribute, and the <var>intended parent</var> is in the same
+   data-x="attr-fae-form">form</code> attribute, and the <var>intendedParent</var> is in the same
    <span>tree</span> as the element pointed to by the <span><code data-x="">form</code> element
    pointer</span>, then <span data-x="concept-form-association">associate</span> <var>element</var>
    with the <code>form</code> element pointed to by the <span><code data-x="">form</code> element
@@ -130991,20 +130993,18 @@ dictionary <dfn dictionary>StorageEventInit</dfn> : <span>EventInit</span> {
          https://www.w3.org/Bugs/Public/show_bug.cgi?id=18367
        Not sure what we could call them instead, though... -->
 
-  <p>When the steps below require the user agent to <dfn>insert a foreign element</dfn> for a token
-  in a given namespace and with a boolean <var>onlyAddToElementStack</var>, the user agent must run
-  these steps:</p>
+  <p>To <dfn>insert a foreign element</dfn>, given a token <var>token</var>, a string
+  <var>namespace</var>, and a boolean <var>onlyAddToElementStack</var>:</p>
 
   <ol>
-   <li><p>Let the <var>adjusted insertion location</var> be the <span>appropriate place for
-   inserting a node</span>.</p></li>
+   <li><p>Let the <var>adjustedInsertionLocation</var> be the <span>appropriate place for inserting
+   a node</span>.</p></li>
 
    <!-- this insertion stuff should be cleaned up: https://github.com/whatwg/html/issues/1706 -->
 
    <li><p>Let <var>element</var> be the result of <span data-x="create an element for the
-   token">creating an element for the token</span> in the given namespace, with the intended
-   parent being the element in which the <var>adjusted insertion location</var> finds
-   itself.</p></li>
+   token">creating an element for the token</span> given <var>token</var>, <var>namespace</var>,
+   and the element in which the <var>adjustedInsertionLocation</var> finds itself.</p></li>
 
    <li><p>If <var>onlyAddToElementStack</var> is false, then run <span>insert an element at the
    adjusted insertion location</span> with <var>element</var>.</p></li>
@@ -131015,9 +131015,8 @@ dictionary <dfn dictionary>StorageEventInit</dfn> : <span>EventInit</span> {
    <li><p>Return <var>element</var>.</p></li>
   </ol>
 
-  <p>When the steps below require the user agent to <dfn>insert an HTML element</dfn> for a token,
-  the user agent must <span>insert a foreign element</span> for the token, with the <span>HTML
-  namespace</span> and false.</p>
+  <p>To <dfn>insert an HTML element</dfn> given a token <var>token</var>: <span>insert a foreign
+  element</span> given <var>token</var>, the <span>HTML namespace</span>, and false.</p>
 
   <hr>