Skip to content

Commit da39d1f

Browse files
annevkannevk
committed
since DOM2 Views is no longer here, no need for DOM features either; also fix typos
1 parent 7575649 commit da39d1f

2 files changed

Lines changed: 45 additions & 76 deletions

File tree

‎cssom-view/Overview.html‎

Lines changed: 39 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -139,65 +139,63 @@ <h2 class="no-num no-toc" id=toc>Table of Contents</h2>
139139
<li><a href="#css-pixels"><span class=secno>2.3. </span>CSS pixels</a>
140140
</ul>
141141

142-
<li><a href="#dom-features"><span class=secno>3. </span>DOM Features</a>
143-
144-
<li><a href="#extensions-to-the-window-interface"><span class=secno>4.
142+
<li><a href="#extensions-to-the-window-interface"><span class=secno>3.
145143
</span>Extensions to the <code title="">Window</code> Interface</a>
146144
<ul class=toc>
147-
<li><a href="#the-stylemedia-interface"><span class=secno>4.1.
145+
<li><a href="#the-stylemedia-interface"><span class=secno>3.1.
148146
</span>The <code title="">StyleMedia</code> Interface</a>
149147

150-
<li><a href="#the-screen-interface"><span class=secno>4.2. </span>The
148+
<li><a href="#the-screen-interface"><span class=secno>3.2. </span>The
151149
<code title="">Screen</code> Interface</a>
152150
</ul>
153151

154-
<li><a href="#extensions-to-the-document-interface"><span class=secno>5.
152+
<li><a href="#extensions-to-the-document-interface"><span class=secno>4.
155153
</span>Extensions to the <code title="">Document</code> Interface</a>
156154
<ul class=toc>
157-
<li><a href="#the-caretposition-interface"><span class=secno>5.1.
155+
<li><a href="#the-caretposition-interface"><span class=secno>4.1.
158156
</span>The <code title="">CaretPosition</code> Interface</a>
159157
</ul>
160158

161-
<li><a href="#extensions-to-the-element-interface"><span class=secno>6.
159+
<li><a href="#extensions-to-the-element-interface"><span class=secno>5.
162160
</span>Extensions to the <code title="">Element</code> Interface</a>
163161
<ul class=toc>
164162
<li><a href="#the-getclientrects-and-getboundingclient"><span
165-
class=secno>6.1. </span>The <code title="">getClientRects()</code> and
163+
class=secno>5.1. </span>The <code title="">getClientRects()</code> and
166164
<code title="">getBoundingClientRect()</code> methods</a>
167165

168-
<li><a href="#scroll-attributes"><span class=secno>6.2. </span>The <code
166+
<li><a href="#scroll-attributes"><span class=secno>5.2. </span>The <code
169167
title="">scrollTop</code>, <code title="">scrollLeft</code>, <code
170168
title="">scrollWidth</code>, and <code title="">scrollHeight</code>
171169
attributes</a>
172170

173-
<li><a href="#client-attributes"><span class=secno>6.3. </span>The <code
171+
<li><a href="#client-attributes"><span class=secno>5.3. </span>The <code
174172
title="">clientTop</code>, <code title="">clientLeft</code>, <code
175173
title="">clientWidth</code>, and <code title="">clientHeight</code>
176174
attributes</a>
177175
</ul>
178176

179177
<li><a href="#extensions-to-the-htmlelement-interface"><span
180-
class=secno>7. </span>Extensions to the <code title="">HTMLElement</code>
178+
class=secno>6. </span>Extensions to the <code title="">HTMLElement</code>
181179
Interface</a>
182180
<ul class=toc>
183-
<li><a href="#offset-attributes"><span class=secno>7.1. </span>The <code
181+
<li><a href="#offset-attributes"><span class=secno>6.1. </span>The <code
184182
title="">offsetParent</code>, <code title="">offsetTop</code>, <code
185183
title="">offsetLeft</code>, <code title="">offsetWidth</code>, and
186184
<code title="">offsetHeight</code> attributes</a>
187185
</ul>
188186

189-
<li><a href="#extensions-to-the-range-interface"><span class=secno>8.
187+
<li><a href="#extensions-to-the-range-interface"><span class=secno>7.
190188
</span>Extensions to the <code title="">Range</code> Interface</a>
191189

192-
<li><a href="#extensions-to-the-mouseevent-interface"><span class=secno>9.
190+
<li><a href="#extensions-to-the-mouseevent-interface"><span class=secno>8.
193191
</span>Extensions to the <code title="">MouseEvent</code> Interface</a>
194192

195-
<li><a href="#rectangles"><span class=secno>10. </span>Rectangles</a>
193+
<li><a href="#rectangles"><span class=secno>9. </span>Rectangles</a>
196194
<ul class=toc>
197-
<li><a href="#the-clientrectlist-interface"><span class=secno>10.1.
195+
<li><a href="#the-clientrectlist-interface"><span class=secno>9.1.
198196
</span>The <code title="">ClientRectList</code> Interface</a>
199197

200-
<li><a href="#the-clientrect-interface"><span class=secno>10.2.
198+
<li><a href="#the-clientrect-interface"><span class=secno>9.2.
201199
</span>The <code title="">ClientRect</code> Interface</a>
202200
</ul>
203201

@@ -213,8 +211,8 @@ <h2 id=background><span class=secno>1. </span>Background</h2>
213211
by browsers for a long period of time. The goal of this specification is
214212
to define these features in such a way that they can be implemented by all
215213
browsers in an interoperable manner. The specification also defines a
216-
couple of new features that will hopefully be useful to Web authors. (If
217-
they are not you can bug us!)
214+
couple of new features that will hopefully be useful to authors. (If they
215+
are not you can bug us!)
218216

219217
<h2 id=conformance><span class=secno>2. </span>Conformance Criteria</h2>
220218

@@ -297,21 +295,7 @@ <h3 id=css-pixels><span class=secno>2.3. </span>CSS pixels</h3>
297295
title=dom-StyleMedia-matchMedia>matchMedia()</code></a> as the units are
298296
explicitly given there.
299297

300-
<h2 id=dom-features><span class=secno>3. </span>DOM Features</h2>
301-
302-
<p>This specification defines the <a
303-
href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMFeatures">DOM
304-
feature</a> "<code>Views</code>" for versions "<code>2.0</code>" and
305-
"<code>3.0</code>". User agents supporting this specification <em
306-
class=ct>must</em> support that feature and versions. [<cite><a
307-
href="#ref-dom3core">DOM3Core</a></cite>]
308-
309-
<p>Authors are encouraged to stay away from DOM features as user agents
310-
claiming to support the DOM feature might not support the feature you need
311-
and user agents supporting parts of the specification might not claim
312-
support for the DOM feature.
313-
314-
<h2 id=extensions-to-the-window-interface><span class=secno>4.
298+
<h2 id=extensions-to-the-window-interface><span class=secno>3.
315299
</span>Extensions to the <code title="">Window</code> Interface</h2>
316300

317301
<pre class=idl>[Supplemental] interface <a href="#window">Window</a> {
@@ -475,7 +459,7 @@ <h2 id=extensions-to-the-window-interface><span class=secno>4.
475459
If there is no client window this attribute <em class=ct>must</em> return
476460
zero.
477461

478-
<h3 id=the-stylemedia-interface><span class=secno>4.1. </span>The <code
462+
<h3 id=the-stylemedia-interface><span class=secno>3.1. </span>The <code
479463
title="">StyleMedia</code> Interface</h3>
480464

481465
<pre class=idl>interface <dfn id=stylemedia>StyleMedia</dfn> {
@@ -624,7 +608,7 @@ <h3 id=the-stylemedia-interface><span class=secno>4.1. </span>The <code
624608
}</code></pre>
625609
</div>
626610

627-
<h3 id=the-screen-interface><span class=secno>4.2. </span>The <code
611+
<h3 id=the-screen-interface><span class=secno>3.2. </span>The <code
628612
title="">Screen</code> Interface</h3>
629613

630614
<p>As its name suggests, the <a href="#screen"><code>Screen</code></a>
@@ -661,7 +645,7 @@ <h3 id=the-screen-interface><span class=secno>4.2. </span>The <code
661645
return zero.</p>
662646
<!-- pixelDepth is not supported by Internet Explorer 7 -->
663647

664-
<h2 id=extensions-to-the-document-interface><span class=secno>5.
648+
<h2 id=extensions-to-the-document-interface><span class=secno>4.
665649
</span>Extensions to the <code title="">Document</code> Interface</h2>
666650

667651
<pre class=idl>[Supplemental] interface <a href="#document">Document</a> {
@@ -757,7 +741,7 @@ <h2 id=extensions-to-the-document-interface><span class=secno>5.
757741
are therefore too. Hit testing will hopefully be defined in a future
758742
revision of CSS or HTML.
759743

760-
<h3 id=the-caretposition-interface><span class=secno>5.1. </span>The <code
744+
<h3 id=the-caretposition-interface><span class=secno>4.1. </span>The <code
761745
title="">CaretPosition</code> Interface</h3>
762746

763747
<p>A <dfn id=caret-position>caret position</dfn> gives the position of a
@@ -785,7 +769,7 @@ <h3 id=the-caretposition-interface><span class=secno>5.1. </span>The <code
785769
class=ct>must</em> return the <a href="#caret-range">caret range</a>.</p>
786770
<!-- https://bugs.webkit.org/show_bug.cgi?id=27046 -->
787771

788-
<h2 id=extensions-to-the-element-interface><span class=secno>6.
772+
<h2 id=extensions-to-the-element-interface><span class=secno>5.
789773
</span>Extensions to the <code title="">Element</code> Interface</h2>
790774

791775
<pre class=idl>[Supplemental] interface <a href="#element">Element</a> {
@@ -803,14 +787,14 @@ <h2 id=extensions-to-the-element-interface><span class=secno>6.
803787
readonly attribute long <a href="#dom-element-clientheight">clientHeight</a>;
804788
};</pre>
805789

806-
<h3 id=the-getclientrects-and-getboundingclient><span class=secno>6.1.
790+
<h3 id=the-getclientrects-and-getboundingclient><span class=secno>5.1.
807791
</span>The <code title="">getClientRects()</code> and <code
808792
title="">getBoundingClientRect()</code> methods</h3>
809793

810794
<p>The <a
811795
href="#dom-element-getclientrects"><code>getClientRects()</code></a> and
812796
<a
813-
href="#dom-element-getboundingclientrect"><code>getBoundingClientRect</code></a>
797+
href="#dom-element-getboundingclientrect"><code>getBoundingClientRect()</code></a>
814798
methods provide information about the position of the border box edges of
815799
an element relative to the viewport. The objects these methods return <em
816800
class=ct>must</em> be static. That is, changes to the underlying document
@@ -834,7 +818,7 @@ <h3 id=the-getclientrects-and-getboundingclient><span class=secno>6.1.
834818
the <code>http://www.w3.org/2000/svg</code> namespace return a <a
835819
href="#clientrectlist"><code>ClientRectList</code></a> object containing
836820
a single <a href="#clientrect"><code>ClientRect</code></a> object that
837-
describes the bounding box of the element as defined by SVG
821+
describes the bounding box of the element as defined by the SVG
838822
specification. [<cite><a href="#ref-svg">SVG</a></cite>]
839823

840824
<li>
@@ -900,7 +884,7 @@ <h3 id=the-getclientrects-and-getboundingclient><span class=secno>6.1.
900884
var exampleHeight = example.height;</code></pre>
901885
</div>
902886

903-
<h3 id=scroll-attributes><span class=secno>6.2. </span>The <code
887+
<h3 id=scroll-attributes><span class=secno>5.2. </span>The <code
904888
title="">scrollTop</code>, <code title="">scrollLeft</code>, <code
905889
title="">scrollWidth</code>, and <code title="">scrollHeight</code>
906890
attributes</h3>
@@ -922,7 +906,7 @@ <h3 id=scroll-attributes><span class=secno>6.2. </span>The <code
922906

923907
<p>When setting the <a
924908
href="#dom-element-scrolltop"><code>scrollTop</code></a> attribute to <var
925-
title="">y</var> on element <var>A</var> user agents <em
909+
title="">y</var> on element <var>A</var>, user agents <em
926910
class=ct>must</em> run the following algorithm:
927911

928912
<ol>
@@ -964,7 +948,7 @@ <h3 id=scroll-attributes><span class=secno>6.2. </span>The <code
964948

965949
<p>When setting the <a
966950
href="#dom-element-scrollleft"><code>scrollLeft</code></a> attribute to
967-
<var title="">x</var> on element <var>A</var> user agents <em
951+
<var title="">x</var> on element <var>A</var>, user agents <em
968952
class=ct>must</em> run the following algorithm:
969953

970954
<ol>
@@ -1044,7 +1028,7 @@ <h3 id=scroll-attributes><span class=secno>6.2. </span>The <code
10441028
</ol>
10451029
<!-- for inline boxes offsetWidth and offsetHeight are identical to offset* -->
10461030

1047-
<h3 id=client-attributes><span class=secno>6.3. </span>The <code
1031+
<h3 id=client-attributes><span class=secno>5.3. </span>The <code
10481032
title="">clientTop</code>, <code title="">clientLeft</code>, <code
10491033
title="">clientWidth</code>, and <code title="">clientHeight</code>
10501034
attributes</h3>
@@ -1085,7 +1069,7 @@ <h3 id=client-attributes><span class=secno>6.3. </span>The <code
10851069
href="#padding-edge">padding edge</a> and the <a
10861070
href="#border-edge">border edge</a>) otherwise.
10871071

1088-
<h2 id=extensions-to-the-htmlelement-interface><span class=secno>7.
1072+
<h2 id=extensions-to-the-htmlelement-interface><span class=secno>6.
10891073
</span>Extensions to the <code title="">HTMLElement</code> Interface</h2>
10901074

10911075
<pre
@@ -1097,7 +1081,7 @@ <h2 id=extensions-to-the-htmlelement-interface><span class=secno>7.
10971081
readonly attribute long <a href="#dom-htmlelement-offsetheight">offsetHeight</a>;
10981082
};</pre>
10991083

1100-
<h3 id=offset-attributes><span class=secno>7.1. </span>The <code
1084+
<h3 id=offset-attributes><span class=secno>6.1. </span>The <code
11011085
title="">offsetParent</code>, <code title="">offsetTop</code>, <code
11021086
title="">offsetLeft</code>, <code title="">offsetWidth</code>, and <code
11031087
title="">offsetHeight</code> attributes</h3>
@@ -1253,7 +1237,7 @@ <h3 id=offset-attributes><span class=secno>7.1. </span>The <code
12531237
<var>A</var>.
12541238
</ol>
12551239

1256-
<h2 id=extensions-to-the-range-interface><span class=secno>8.
1240+
<h2 id=extensions-to-the-range-interface><span class=secno>7.
12571241
</span>Extensions to the <code title="">Range</code> Interface</h2>
12581242

12591243
<pre class=idl>[Supplemental] interface <a href="#range">Range</a> {
@@ -1320,7 +1304,7 @@ <h2 id=extensions-to-the-range-interface><span class=secno>8.
13201304
which the height or width is not zero.
13211305
</ol>
13221306

1323-
<h2 id=extensions-to-the-mouseevent-interface><span class=secno>9.
1307+
<h2 id=extensions-to-the-mouseevent-interface><span class=secno>8.
13241308
</span>Extensions to the <code title="">MouseEvent</code> Interface</h2>
13251309

13261310
<pre
@@ -1393,10 +1377,10 @@ <h2 id=extensions-to-the-mouseevent-interface><span class=secno>9.
13931377
event occurred relative to the origin of the <a
13941378
href="#padding-edge">padding edge</a> of the target node.
13951379

1396-
<h2 id=rectangles><span class=secno>10. </span>Rectangles</h2>
1380+
<h2 id=rectangles><span class=secno>9. </span>Rectangles</h2>
13971381

1398-
<h3 id=the-clientrectlist-interface><span class=secno>10.1. </span>The
1399-
<code title="">ClientRectList</code> Interface</h3>
1382+
<h3 id=the-clientrectlist-interface><span class=secno>9.1. </span>The <code
1383+
title="">ClientRectList</code> Interface</h3>
14001384

14011385
<p>The <a href="#clientrectlist"><code>ClientRectList</code></a> object
14021386
consists of an ordered list of <a
@@ -1422,7 +1406,7 @@ <h3 id=the-clientrectlist-interface><span class=secno>10.1. </span>The
14221406
object. Otherwise, the <a href="#clientrect"><code>ClientRect</code></a>
14231407
object at <var title="">index</var> <em class=ct>must</em> be returned.
14241408

1425-
<h3 id=the-clientrect-interface><span class=secno>10.2. </span>The <code
1409+
<h3 id=the-clientrect-interface><span class=secno>9.2. </span>The <code
14261410
title="">ClientRect</code> Interface</h3>
14271411

14281412
<p>Objects implementing the <a

‎cssom-view/Overview.src.html‎

Lines changed: 6 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -81,8 +81,8 @@ <h2 id="background">Background</h2>
8181
by browsers for a long period of time. The goal of this specification is
8282
to define these features in such a way that they can be implemented by all
8383
browsers in an interoperable manner. The specification also defines a
84-
couple of new features that will hopefully be useful to Web authors. (If
85-
they are not you can bug us!)</p>
84+
couple of new features that will hopefully be useful to authors. (If they
85+
are not you can bug us!)</p>
8686

8787

8888
<h2 id="conformance">Conformance Criteria</h2>
@@ -169,21 +169,6 @@ <h3>CSS pixels</h3>
169169
are explicitly given there.</p>
170170

171171

172-
<h2 id="dom-features">DOM Features</h2>
173-
174-
<p>This specification defines the
175-
<a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMFeatures">DOM
176-
feature</a> "<code>Views</code>" for versions "<code>2.0</code>" and
177-
"<code>3.0</code>". User agents supporting this specification
178-
<em class="ct">must</em> support that feature and versions.
179-
[<cite><span>DOM3Core</span></cite>]</p>
180-
181-
<p>Authors are encouraged to stay away from DOM features as user agents
182-
claiming to support the DOM feature might not support the feature you need
183-
and user agents supporting parts of the specification might not claim
184-
support for the DOM feature.</p>
185-
186-
187172

188173
<h2 id="extensions-to-the-window-interface">Extensions to the <code title="">Window</code> Interface</h2>
189174

@@ -642,7 +627,7 @@ <h2 id="extensions-to-the-element-interface">Extensions to the <code title="">El
642627
<h3>The <code title="">getClientRects()</code> and
643628
<code title="">getBoundingClientRect()</code> methods</h3>
644629

645-
<p>The <code>getClientRects()</code> and <code>getBoundingClientRect</code>
630+
<p>The <code>getClientRects()</code> and <code>getBoundingClientRect()</code>
646631
methods provide information about the position of the border box edges of
647632
an element relative to the viewport. The objects these methods return
648633
<em class="ct">must</em> be static. That is, changes to the underlying
@@ -663,7 +648,7 @@ <h3>The <code title="">getClientRects()</code> and
663648
in the <code>http://www.w3.org/2000/svg</code> namespace return a
664649
<code>ClientRectList</code> object containing a single
665650
<code>ClientRect</code> object that describes the bounding box of the
666-
element as defined by SVG specification.
651+
element as defined by the SVG specification.
667652
[<cite><span>SVG</span></cite>]</p></li>
668653

669654
<li>
@@ -739,7 +724,7 @@ <h3 id="scroll-attributes">The <code title="">scrollTop</code>,
739724
</ol>
740725

741726
<p>When setting the <code>scrollTop</code> attribute to
742-
<var title="">y</var> on element <var>A</var> user agents
727+
<var title="">y</var> on element <var>A</var>, user agents
743728
<em class="ct">must</em> run the
744729
following algorithm:</p>
745730

@@ -774,7 +759,7 @@ <h3 id="scroll-attributes">The <code title="">scrollTop</code>,
774759
</ol>
775760

776761
<p>When setting the <code>scrollLeft</code> attribute to <var title="">x</var>
777-
on element <var>A</var> user agents <em class="ct">must</em> run the
762+
on element <var>A</var>, user agents <em class="ct">must</em> run the
778763
following algorithm:</p>
779764

780765
<ol>

0 commit comments

Comments
 (0)