Skip to content
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

Jump to bottom

Remove Goals and Historical sections #918

Merged
merged 5 commits into from
Nov 9, 2020
Merged

Remove Goals and Historical sections #918

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8587e15
Remove Goals and Historical sections
annevk Nov 6, 2020
de4c861
restore some historical context
annevk Nov 9, 2020
0d6e2b1
rename // historical to // legacy to avoid confusion
annevk Nov 9, 2020
ecd56a1
provide a tiny bit of context
annevk Nov 9, 2020
643e4d8
stop mentioning things that moved
annevk Nov 9, 2020
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
190 changes: 0 additions & 190 deletions dom.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,43 +49,6 @@ spec:html; type:element



<h2 id=goals class=no-num>Goals</h2>

This specification standardizes the DOM. It does so as follows:

<ol>
<li>
<p>By consolidating <cite>DOM Level 3 Core</cite> [[DOM-Level-3-Core]],
<cite>Element Traversal</cite> [[ELEMENTTRAVERSAL]],
<cite>Selectors API Level 2</cite> [[SELECTORS-API2]], the
"DOM Event Architecture" and "Basic Event Interfaces" chapters of
<cite>DOM Level 3 Events</cite> [[uievents-20031107]] (specific types of events do not
belong in the DOM Standard), and <cite>DOM Level 2 Traversal and Range</cite>
[[DOM-Level-2-Traversal-Range]], and:

<ul class=brief>
<li>Aligning them with the JavaScript ecosystem where possible.
<li>Aligning them with existing implementations.
<li>Simplifying them as much as possible.
</ul>

<li><p>By moving features from the HTML Standard [[!HTML]] that make more sense to be
specified as part of the DOM Standard.

<li>
<p>By defining a replacement for the "Mutation Events" and
"Mutation Name Event Types" chapters of <cite>DOM Level 3 Events</cite>
[[uievents-20031107]] as the old model
was problematic.

<p class="note no-backref">The old model is expected to be removed from implementations
in due course.

<li><p>By defining new features that simplify common DOM operations.
</ol>



<h2 id=infrastructure oldids=terminology,dependencies>Infrastructure</h2>

<p>This specification depends on the Infra Standard. [[!INFRA]]
Expand Down Expand Up @@ -9875,159 +9838,6 @@ methods on {{Document}}.



<h2 id=historical>Historical</h2>

<p>As explained in <a href="#goals">goals</a> this standard is a significant revision of various
obsolete DOM specifications. This section enumerates the incompatible changes.


<h3 id=dom-events-changes>DOM Events</h3>

<p>These are the changes made to the features described in the "DOM Event Architecture",
"Basic Event Interfaces", "Mutation Events", and "Mutation Name Event Types" chapters of
<cite>DOM Level 3 Events</cite>. The other chapters are defined by the <cite>UI Events</cite>
specification. [[!UIEVENTS]]

<ul class=brief>
<li>Removes <dfn interface>MutationEvent</dfn> and <dfn interface>MutationNameEvent</dfn>.
<li>Fire is no longer synonymous with dispatch, but includes initializing an event.
<li>The propagation and canceled flags are unset when invoking {{Event/initEvent()}} rather than
after dispatch.
<li>{{Event}}'s {{Event/timeStamp}} attribute is a {{DOMHighResTimeStamp}} rather than a
{{DOMTimeStamp}}.
</ul>


<h3 id=dom-core-changes>DOM Core</h3>

<p>These are the changes made to the features described in <cite>DOM Level 3 Core</cite>.

<p>{{DOMString}}, {{DOMException}}, and {{DOMTimeStamp}} are now defined in Web IDL.

<p id=domstringlist>{{DOMStringList}} is now defined in HTML.

<p><dfn method for=Node><code>hasAttributes()</code></dfn> and
<dfn attribute for=Node><code>attributes</code></dfn> moved from {{Node}} to {{Element}}.

<p><dfn attribute for=Node><code>namespaceURI</code></dfn>,
<dfn attribute for=Node><code>prefix</code></dfn>, and
<dfn attribute for=Node><code>localName</code></dfn> moved from {{Node}} to {{Element}} and
{{Attr}}.

<p>The remainder of interfaces and interface members listed in this section were removed to simplify
the web platform. Implementations conforming to this specification will not support them.

<p>Interfaces:

<ul class=brief dfn-type="interface">
<li><dfn><code>DOMConfiguration</code></dfn>
<li><dfn><code>DOMError</code></dfn>
<li><dfn><code>DOMErrorHandler</code></dfn>
<li><dfn><code>DOMImplementationList</code></dfn>
<li><dfn><code>DOMImplementationSource</code></dfn>
<li><dfn><code>DOMLocator</code></dfn>
<li><dfn><code>DOMObject</code></dfn>
<li><dfn><code>DOMUserData</code></dfn>
<li><dfn><code>Entity</code></dfn>
<li><dfn><code>EntityReference</code></dfn>
<li><dfn><code>NameList</code></dfn>
<li><dfn><code>Notation</code></dfn>
<li><dfn><code>TypeInfo</code></dfn>
<li><dfn><code>UserDataHandler</code></dfn>
</ul>

<p>Interface members:

<dl>
<dt>{{Node}}
<dd>
<ul class=brief>
<li><dfn attribute for=Node><code>isSupported</code></dfn>
<li><dfn method for=Node><code>getFeature()</code></dfn>
<li><dfn method for=Node><code>getUserData()</code></dfn>
<li><dfn method for=Node><code>setUserData()</code></dfn>
</ul>

<dt>{{Document}}
<dd>
<ul class=brief>
<li><dfn method for=Document><code>createEntityReference()</code></dfn>
<li><dfn attribute for=Document><code>xmlEncoding</code></dfn>
<li><dfn attribute for=Document><code>xmlStandalone</code></dfn>
<li><dfn attribute for=Document><code>xmlVersion</code></dfn>
<li><dfn attribute for=Document><code>strictErrorChecking</code></dfn>
<li><dfn attribute for=Document><code>domConfig</code></dfn>
<li><dfn method for=Document><code>normalizeDocument()</code></dfn>
<li><dfn method for=Document><code>renameNode()</code></dfn>
</ul>

<dt>{{DOMImplementation}}
<dd>
<ul class=brief>
<li><dfn method for=DOMImplementation><code>getFeature()</code></dfn>
</ul>

<dt>{{Attr}}
<dd>
<ul class=brief>
<li><dfn attribute for=Attr><code>schemaTypeInfo</code></dfn>
<li><dfn attribute for=Attr><code>isId</code></dfn>
</ul>

<dt>{{Element}}
<dd>
<ul class=brief>
<li><dfn attribute for=Element><code>schemaTypeInfo</code></dfn>
<li><dfn method for=Element><code>setIdAttribute()</code></dfn>
<li><dfn method for=Element><code>setIdAttributeNS()</code></dfn>
<li><dfn method for=Element><code>setIdAttributeNode()</code></dfn>
</ul>

<dt>{{DocumentType}}
<dd>
<ul class=brief>
<li><dfn attribute for=DocumentType><code>entities</code></dfn>
<li><dfn attribute for=DocumentType><code>notations</code></dfn>
<li><dfn attribute for=DocumentType><code>internalSubset</code></dfn>
</ul>

<dt>{{Text}}
<dd>
<ul class=brief>
<li><dfn attribute for=Text><code>isElementContentWhitespace</code></dfn>
<li><dfn method for=Text><code>replaceWholeText()</code></dfn>
</ul>
</dl>


<h3 id=dom-ranges-changes>DOM Ranges</h3>

<p>These are the changes made to the features described in the "Document Object Model Range" chapter
of <cite>DOM Level 2 Traversal and Range</cite>.

<ul class=brief>
<li><dfn interface>RangeException</dfn> has been removed.
<li>{{Range/detach()}} is now a no-op.
</ul>


<h3 id=dom-traversal-changes>DOM Traversal</h3>

<p>These are the changes made to the features described in the "Document Object Model Traversal"
chapter of <cite>DOM Level 2 Traversal and Range</cite>.

<ul class=brief>
<li>{{createNodeIterator()}} and {{createTreeWalker()}} now have optional arguments and lack a
fourth argument which is no longer relevant given entity references never made it into the DOM.
<li>The <dfn for="NodeIterator, TreeWalker" attribute>expandEntityReferences</dfn> attribute has
been removed from the {{NodeIterator}} and {{TreeWalker}} interfaces for the aforementioned reason.
<li>{{NodeIterator/nextNode()}} and {{NodeIterator/previousNode()}} now throw when invoked from a
{{NodeFilter}} to align with user agents.
<li>{{NodeIterator/detach()}} is now a no-op.
</ul>



<h2 class=no-num id="acks">Acknowledgments</h2>

<p>There have been a lot of people that have helped make DOM more interoperable over the years and
Expand Down