Skip to content

Editorial: cleanup "create an element" #1331

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
annevk merged 1 commit into from
Dec 12, 2024
Merged

Editorial: cleanup "create an element" #1331

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 20 additions & 27 deletions dom.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4561,11 +4561,10 @@ dom-Range-extractContents, dom-Range-cloneContents -->
<li><p>Let <var>copy</var> be the result of <a>creating an element</a>, given
<var>document</var>, <var>node</var>'s <a for=Element>local name</a>, <var>node</var>'s
<a for=Element>namespace</a>, <var>node</var>'s <a for=Element>namespace prefix</a>, and
<var>node</var>'s <a><code>is</code> value</a>, with the <var>synchronous custom elements
flag</var> unset.
<var>node</var>'s <a><code>is</code> value</a>.

<li>
<p><a for=list>For each</a> <var>attribute</var> in <var>node</var>'s
<p><a for=list>For each</a> <var>attribute</var> of <var>node</var>'s
<a for=Element>attribute list</a>:

<ol>
Expand Down Expand Up @@ -5461,8 +5460,7 @@ method steps are:
"<code>application/xhtml+xml</code>"; otherwise null.

<li><p>Return the result of <a>creating an element</a> given <a>this</a>, <var>localName</var>,
<var>namespace</var>, null, <var>is</var>, and with the <var>synchronous custom elements</var> flag
set.
<var>namespace</var>, null, <var>is</var>, and true.
</ol>

<p>The <dfn noexport>internal <code>createElementNS</code> steps</dfn>, given <var>document</var>,
Expand All @@ -5479,8 +5477,7 @@ method steps are:
to it.

<li><p>Return the result of <a>creating an element</a> given <var>document</var>,
<var>localName</var>, <var>namespace</var>, <var>prefix</var>, <var>is</var>, and with the
<var>synchronous custom elements</var> flag set.
<var>localName</var>, <var>namespace</var>, <var>prefix</var>, <var>is</var>, and true.
</ol>

<p>The
Expand Down Expand Up @@ -5908,26 +5905,26 @@ method steps are:
<a for=DocumentType>name</a> and with its <a for=Node>node document</a> set to <var>doc</var>, to
<var>doc</var>.

<li><p><a>Append</a> the result of <a>creating an element</a> given <var>doc</var>, <{html}>, and
the <a>HTML namespace</a>, to <var>doc</var>.
<li><p><a>Append</a> the result of <a>creating an element</a> given <var>doc</var>,
"<code>html</code>", and the <a>HTML namespace</a>, to <var>doc</var>.

<li><p><a>Append</a> the result of <a>creating an element</a> given <var>doc</var>, <{head}>, and
the <a>HTML namespace</a>, to the <{html}> element created earlier.
<li><p><a>Append</a> the result of <a>creating an element</a> given <var>doc</var>,
"<code>head</code>", and the <a>HTML namespace</a>, to the <{html}> element created earlier.

<li>
<p>If <var>title</var> is given:

<ol>
<li><p><a>Append</a> the result of <a>creating an element</a> given <var>doc</var>, <{title}>,
and the <a>HTML namespace</a>, to the <{head}> element created earlier.
<li><p><a>Append</a> the result of <a>creating an element</a> given <var>doc</var>,
"<code>title</code>", and the <a>HTML namespace</a>, to the <{head}> element created earlier.

<li><p><a>Append</a> a new {{Text}} <a for=/>node</a>, with its <a for=CharacterData>data</a> set
to <var>title</var> (which could be the empty string) and its <a for=Node>node document</a> set
to <var>doc</var>, to the <{title}> element created earlier.
</ol>

<li><p><a>Append</a> the result of <a>creating an element</a> given <var>doc</var>, <{body}>, and
the <a>HTML namespace</a>, to the <{html}> element created earlier.</li>
<li><p><a>Append</a> the result of <a>creating an element</a> given <var>doc</var>,
"<code>body</code>", and the <a>HTML namespace</a>, to the <{html}> element created earlier.</li>

<li><p><var>doc</var>'s <a for=Document>origin</a> is <a>this</a>'s associated <a>document</a>'s
<a for=Document>origin</a>.
Expand Down Expand Up @@ -6306,16 +6303,12 @@ value of these steps:
<p class=note>User agents could optimize <a for=Element>qualified name</a> and
<a for=Element>HTML-uppercased qualified name</a> by storing them in internal slots.

<p>To
<dfn export id=concept-create-element lt="create an element|creating an element">create an element</dfn>,
given a <var>document</var>, <var>localName</var>, <var>namespace</var>, and optional
<var>prefix</var>, <var>is</var>, and <var>synchronous custom elements flag</var>, run these steps:
<p>To <dfn export id=concept-create-element>create an element</dfn>, given a <a for=/>document</a>
<var>document</var>, string <var>localName</var>, string-or-null <var>namespace</var>, and
optionally a string-or-null <var>prefix</var> (default null), string-or-null <var>is</var> (default
null), and boolean <var>synchronousCustomElements</var> (default false):

<ol>
<li><p>If <var>prefix</var> was not given, let <var>prefix</var> be null.

<li><p>If <var>is</var> was not given, let <var>is</var> be null.

<li><p>Let <var>result</var> be null.

<li><p>Let <var>definition</var> be the result of
Expand All @@ -6341,8 +6334,8 @@ given a <var>document</var>, <var>localName</var>, <var>namespace</var>, and opt
<var>document</var>.

<li>
<p>If the <var>synchronous custom elements flag</var> is set, then run this step while
catching any exceptions:
<p>If <var>synchronousCustomElements</var> is true, then run this step while catching any
exceptions:
Copy link
Member

@domfarolino domfarolino Dec 12, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe not for this PR, but I guess we should not say anything here about exceptions, and just link to https://webidl.spec.whatwg.org/#an-exception-was-thrown somewhere in "If this step threw an exception" below. Doesn't need to happen in this PR I guess.

Copy link
Member Author

@annevk annevk Dec 12, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh yes, that would be nice to adopt.


<ol>
<li><p><a lt="upgrade an element">Upgrade</a> <var>result</var> using <var>definition</var>.
Expand Down Expand Up @@ -6370,8 +6363,8 @@ given a <var>document</var>, <var>localName</var>, <var>namespace</var>, and opt

<ol>
<li>
<p>If the <var>synchronous custom elements flag</var> is set, then run these steps while
catching any exceptions:
<p>If <var>synchronousCustomElements</var> is true, then run these steps while catching any
exceptions:

<ol>
<li><p>Let <var>C</var> be <var>definition</var>'s
Expand Down