Skip to content

Remove Goals and Historical sections #918

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
merged 5 commits into from
Nov 9, 2020
Merged

Remove Goals and Historical sections #918

Changes from 4 commits
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
191 changes: 53 additions & 138 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 @@ -417,7 +380,7 @@ interface Event {

readonly attribute DOMString type;
readonly attribute EventTarget? target;
readonly attribute EventTarget? srcElement; // historical
readonly attribute EventTarget? srcElement; // legacy
readonly attribute EventTarget? currentTarget;
sequence&lt;EventTarget> composedPath();

Expand All @@ -428,20 +391,20 @@ interface Event {
readonly attribute unsigned short eventPhase;

undefined stopPropagation();
attribute boolean cancelBubble; // historical alias of .stopPropagation
attribute boolean cancelBubble; // legacy alias of .stopPropagation()
undefined stopImmediatePropagation();

readonly attribute boolean bubbles;
readonly attribute boolean cancelable;
attribute boolean returnValue; // historical
attribute boolean returnValue; // legacy
undefined preventDefault();
readonly attribute boolean defaultPrevented;
readonly attribute boolean composed;

[LegacyUnforgeable] readonly attribute boolean isTrusted;
readonly attribute DOMHighResTimeStamp timeStamp;

undefined initEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false); // historical
undefined initEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false); // legacy
};

dictionary EventInit {
Expand Down Expand Up @@ -809,7 +772,7 @@ incapable of setting {{Event/composed}}. It has to be supported for legacy conte

<pre class=idl>
partial interface Window {
[Replaceable] readonly attribute any event; // historical
[Replaceable] readonly attribute any event; // legacy
};
</pre>

Expand All @@ -833,7 +796,7 @@ interface CustomEvent : Event {

readonly attribute any detail;

undefined initCustomEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any detail = null); // historical
undefined initCustomEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any detail = null); // legacy
};

dictionary CustomEventInit : EventInit {
Expand Down Expand Up @@ -3711,14 +3674,14 @@ interface Node : EventTarget {
const unsigned short ATTRIBUTE_NODE = 2;
const unsigned short TEXT_NODE = 3;
const unsigned short CDATA_SECTION_NODE = 4;
const unsigned short ENTITY_REFERENCE_NODE = 5; // historical
const unsigned short ENTITY_NODE = 6; // historical
const unsigned short ENTITY_REFERENCE_NODE = 5; // legacy
const unsigned short ENTITY_NODE = 6; // legacy
const unsigned short PROCESSING_INSTRUCTION_NODE = 7;
const unsigned short COMMENT_NODE = 8;
const unsigned short DOCUMENT_NODE = 9;
const unsigned short DOCUMENT_TYPE_NODE = 10;
const unsigned short DOCUMENT_FRAGMENT_NODE = 11;
const unsigned short NOTATION_NODE = 12; // historical
const unsigned short NOTATION_NODE = 12; // legacy
readonly attribute unsigned short nodeType;
readonly attribute DOMString nodeName;

Expand All @@ -3742,7 +3705,7 @@ interface Node : EventTarget {

[CEReactions, NewObject] Node cloneNode(optional boolean deep = false);
boolean isEqualNode(Node? otherNode);
boolean isSameNode(Node? otherNode); // historical alias of ===
boolean isSameNode(Node? otherNode); // legacy alias of ===

const unsigned short DOCUMENT_POSITION_DISCONNECTED = 0x01;
const unsigned short DOCUMENT_POSITION_PRECEDING = 0x02;
Expand Down Expand Up @@ -4769,8 +4732,8 @@ interface Document : Node {
readonly attribute USVString documentURI;
readonly attribute DOMString compatMode;
readonly attribute DOMString characterSet;
readonly attribute DOMString charset; // historical alias of .characterSet
readonly attribute DOMString inputEncoding; // historical alias of .characterSet
readonly attribute DOMString charset; // legacy alias of .characterSet
readonly attribute DOMString inputEncoding; // legacy alias of .characterSet
readonly attribute DOMString contentType;

readonly attribute DocumentType? doctype;
Expand All @@ -4793,7 +4756,7 @@ interface Document : Node {
[NewObject] Attr createAttribute(DOMString localName);
[NewObject] Attr createAttributeNS(DOMString? namespace, DOMString qualifiedName);

[NewObject] Event createEvent(DOMString interface); // historical
[NewObject] Event createEvent(DOMString interface); // legacy

[NewObject] Range createRange();

Expand Down Expand Up @@ -5851,14 +5814,14 @@ interface Element : Node {

Element? closest(DOMString selectors);
boolean matches(DOMString selectors);
boolean webkitMatchesSelector(DOMString selectors); // historical alias of .matches
boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches

HTMLCollection getElementsByTagName(DOMString qualifiedName);
HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
HTMLCollection getElementsByClassName(DOMString classNames);

[CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // historical
undefined insertAdjacentText(DOMString where, DOMString data); // historical
[CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
undefined insertAdjacentText(DOMString where, DOMString data); // legacy
};

dictionary ShadowRootInit {
Expand Down Expand Up @@ -9455,14 +9418,14 @@ callback interface NodeFilter {
const unsigned long SHOW_ATTRIBUTE = 0x2;
const unsigned long SHOW_TEXT = 0x4;
const unsigned long SHOW_CDATA_SECTION = 0x8;
const unsigned long SHOW_ENTITY_REFERENCE = 0x10; // historical
const unsigned long SHOW_ENTITY = 0x20; // historical
const unsigned long SHOW_ENTITY_REFERENCE = 0x10; // legacy
const unsigned long SHOW_ENTITY = 0x20; // legacy
const unsigned long SHOW_PROCESSING_INSTRUCTION = 0x40;
const unsigned long SHOW_COMMENT = 0x80;
const unsigned long SHOW_DOCUMENT = 0x100;
const unsigned long SHOW_DOCUMENT_TYPE = 0x200;
const unsigned long SHOW_DOCUMENT_FRAGMENT = 0x400;
const unsigned long SHOW_NOTATION = 0x800; // historical
const unsigned long SHOW_NOTATION = 0x800; // legacy

unsigned short acceptNode(Node node);
};
Expand Down Expand Up @@ -9877,47 +9840,11 @@ 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 id=domstringlist>Contrary to earlier revisions of this standard, {{DOMString}}, {{DOMException}},
and {{DOMTimeStamp}} are now defined in Web IDL. {{DOMStringList}} is now defined in HTML.
[[WEBIDL]] [[HTML]]
Copy link
Member

Choose a reason for hiding this comment

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

I'd lean toward omitting these too, since they have a home that people can find without too much effort. It's the ones that totally disappeared that it seems nice to keep some record of. (But, no big deal either way.)


<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:
<p>These interfaces have been removed:

<ul class=brief dfn-type="interface">
<li><dfn><code>DOMConfiguration</code></dfn>
Expand All @@ -9930,22 +9857,23 @@ the web platform. Implementations conforming to this specification will not supp
<li><dfn><code>DOMUserData</code></dfn>
<li><dfn><code>Entity</code></dfn>
<li><dfn><code>EntityReference</code></dfn>
<li><dfn><code>MutationEvent</code></dfn>
<li><dfn><code>MutationNameEvent</code></dfn>
<li><dfn><code>NameList</code></dfn>
<li><dfn><code>Notation</code></dfn>
<li><dfn><code>RangeException</code></dfn>
<li><dfn><code>TypeInfo</code></dfn>
<li><dfn><code>UserDataHandler</code></dfn>
</ul>

<p>Interface members:
<p>And these interface members have been removed:

<dl>
<dt>{{Node}}
<dt>{{Attr}}
<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>
<li><dfn attribute for=Attr><code>schemaTypeInfo</code></dfn>
<li><dfn attribute for=Attr><code>isId</code></dfn>
</ul>

<dt>{{Document}}
Expand All @@ -9961,17 +9889,18 @@ the web platform. Implementations conforming to this specification will not supp
<li><dfn method for=Document><code>renameNode()</code></dfn>
</ul>

<dt>{{DOMImplementation}}
<dt>{{DocumentType}}
<dd>
<ul class=brief>
<li><dfn method for=DOMImplementation><code>getFeature()</code></dfn>
<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>{{Attr}}
<dt>{{DOMImplementation}}
<dd>
<ul class=brief>
<li><dfn attribute for=Attr><code>schemaTypeInfo</code></dfn>
<li><dfn attribute for=Attr><code>isId</code></dfn>
<li><dfn method for=DOMImplementation><code>getFeature()</code></dfn>
</ul>

<dt>{{Element}}
Expand All @@ -9983,12 +9912,19 @@ the web platform. Implementations conforming to this specification will not supp
<li><dfn method for=Element><code>setIdAttributeNode()</code></dfn>
</ul>

<dt>{{DocumentType}}
<dt>{{Node}}
<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>
<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>{{NodeIterator}}
<dd>
<ul class=brief>
<li><dfn for=NodeIterator attribute>expandEntityReferences</dfn>
</ul>

<dt>{{Text}}
Expand All @@ -9997,34 +9933,13 @@ the web platform. Implementations conforming to this specification will not supp
<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>
<dt>{{TreeWalker}}
<dd>
<ul class=brief>
<li><dfn for=TreeWalker attribute>expandEntityReferences</dfn>
</ul>
</dl>



Expand Down