Skip to content

Commit ef5215c

Browse files
dirkschulzesvgeesus
authored andcommitted
Rename DOMRectList back; Make DOMRectList NoInterfaceObject; Clarify that DOMRectList is zero-based
1 parent 3eefa11 commit ef5215c

File tree

4 files changed

+103
-23
lines changed

4 files changed

+103
-23
lines changed

geometry/Overview.html

Lines changed: 16 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
</p>
2626
<h1 class="p-name no-ref" id=title>Geometry Interfaces Module Level 1</h1>
2727
<h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
28-
<span class=dt-updated><span class=value-title title=20140717>17 July 2014</span></span></span></h2>
28+
<span class=dt-updated><span class=value-title title=20140718>18 July 2014</span></span></span></h2>
2929
<div data-fill-with=spec-metadata><dl>
3030
<dt>This version:
3131
<dd><a class=u-url href=http://dev.w3.org/fxtf/geometry/>http://dev.w3.org/fxtf/geometry/</a>
@@ -99,7 +99,7 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class
9999
<li><a href=#intro><span class=secno>1</span> Introduction</a>
100100
<li><a href=#DOMPoint><span class=secno>2</span> The DOMPoint interfaces</a>
101101
<li><a href=#DOMRect><span class=secno>3</span> The DOMRect interfaces</a>
102-
<li><a href=#DOMRectList><span class=secno>4</span> The LegacyDOMRectList Interface</a>
102+
<li><a href=#DOMRectList><span class=secno>4</span> The DOMRectList Interface</a>
103103
<li><a href=#DOMQuad><span class=secno>5</span> The DOMQuad interface</a>
104104
<li><a href=#DOMMatrix><span class=secno>6</span> The DOMMatrix interfaces</a>
105105
<ul class=toc>
@@ -317,20 +317,21 @@ <h2 class="heading settled heading" data-level=3 id=DOMRect><span class=secno>3
317317
<p>For historical reasons, Window objects must also have a writable, configurable, non-enumerable property named <code>SVGRect</code> whose value is the <a class=idl-code data-link-type=interface href=#dom-domrect title=domrect>DOMRect</a> interface object.</p>
318318

319319
<h2 class="heading settled heading" data-level=4 id=DOMRectList><span class=secno>4 </span><span class=content>
320-
The LegacyDOMRectList Interface</span><a class=self-link href=#DOMRectList></a></h2>
320+
The DOMRectList Interface</span><a class=self-link href=#DOMRectList></a></h2>
321321

322-
<pre class=idl>[ArrayClass]
323-
interface <dfn class=idl-code data-dfn-type=interface data-export="" data-global-name="" id=dom-legacydomrectlist>LegacyDOMRectList<a class=self-link href=#dom-legacydomrectlist></a></dfn> {
324-
readonly attribute unsigned long <a class=idl-code data-global-name="LegacyDOMRectList<interface>/length<attribute>" data-link-for=LegacyDOMRectList data-link-type=attribute data-readonly="" data-type="unsigned long " href=#dom-legacydomrectlist-length title=length>length</a>;
325-
getter <a data-link-type=idl href=#dom-domrect title=domrect>DOMRect</a>? <a class=idl-code data-global-name="LegacyDOMRectList<interface>/item()<method>" data-link-for=LegacyDOMRectList data-link-type=method href=#dom-legacydomrectlist-item title=item()>item</a>(unsigned long <dfn class=idl-code data-dfn-for=LegacyDOMRectList/item() data-dfn-type=argument data-export="" data-global-name="LegacyDOMRectList<interface>/item()<method>/index<argument>" id=dom-legacydomrectlistitem-index>index<a class=self-link href=#dom-legacydomrectlistitem-index></a></dfn>);
322+
<pre class=idl>[NoInterfaceObject,
323+
ArrayClass]
324+
interface <dfn class=idl-code data-dfn-type=interface data-export="" data-global-name="" id=dom-domrectlist>DOMRectList<a class=self-link href=#dom-domrectlist></a></dfn> {
325+
readonly attribute unsigned long <a class=idl-code data-global-name="DOMRectList<interface>/length<attribute>" data-link-for=DOMRectList data-link-type=attribute data-readonly="" data-type="unsigned long " href=#dom-domrectlist-length title=length>length</a>;
326+
getter <a data-link-type=idl href=#dom-domrect title=domrect>DOMRect</a>? <a class=idl-code data-global-name="DOMRectList<interface>/item()<method>" data-link-for=DOMRectList data-link-type=method href=#dom-domrectlist-item title=item()>item</a>(unsigned long <dfn class=idl-code data-dfn-for=DOMRectList/item() data-dfn-type=argument data-export="" data-global-name="DOMRectList<interface>/item()<method>/index<argument>" id=dom-domrectlistitem-index>index<a class=self-link href=#dom-domrectlistitem-index></a></dfn>);
326327
};
327328
</pre>
328329

329-
<p>The <dfn class=idl-code data-dfn-for=LegacyDOMRectList data-dfn-type=attribute data-export="" id=dom-legacydomrectlist-length>length<a class=self-link href=#dom-legacydomrectlist-length></a></dfn> attribute must return the total number of <a class=idl-code data-link-type=interface href=#dom-domrect title=domrect>DOMRect</a> objects associated with the object.</p>
330+
<p>The <dfn class=idl-code data-dfn-for=DOMRectList data-dfn-type=attribute data-export="" id=dom-domrectlist-length>length<a class=self-link href=#dom-domrectlist-length></a></dfn> attribute must return the total number of <a class=idl-code data-link-type=interface href=#dom-domrect title=domrect>DOMRect</a> objects associated with the object.</p>
330331

331-
<p>The <dfn class=idl-code data-dfn-for=LegacyDOMRectList data-dfn-type=method data-export="" id=dom-legacydomrectlist-item title=item()>item(<var>index</var>)<a class=self-link href=#dom-legacydomrectlist-item></a></dfn> method, when invoked, must return a <span class=css data-link-type=maybe title=null>null</span> value when <var>index</var> is greater than or equal to the number of <a class=idl-code data-link-type=interface href=#dom-domrect title=domrect>DOMRect</a> objects associated with the <a class=idl-code data-link-type=interface href=#dom-legacydomrectlist title=legacydomrectlist>LegacyDOMRectList</a>. Otherwise, the <a class=idl-code data-link-type=interface href=#dom-domrect title=domrect>DOMRect</a> object at <var>index</var> must be returned.</p>
332+
<p>The <dfn class=idl-code data-dfn-for=DOMRectList data-dfn-type=method data-export="" id=dom-domrectlist-item title=item()>item(<var>index</var>)<a class=self-link href=#dom-domrectlist-item></a></dfn> method, when invoked, must return a <span class=css data-link-type=maybe title=null>null</span> value when <var>index</var> is greater than or equal to the number of <a class=idl-code data-link-type=interface href=#dom-domrect title=domrect>DOMRect</a> objects associated with the <a class=idl-code data-link-type=interface href=#dom-domrectlist title=domrectlist>DOMRectList</a>. Otherwise, the <a class=idl-code data-link-type=interface href=#dom-domrect title=domrect>DOMRect</a> object at <var>index</var> must be returned. Indices are zero-based.</p>
332333

333-
<strong class=advisement><a class=idl-code data-link-type=interface href=#dom-legacydomrectlist title=legacydomrectlist>LegacyDOMRectList</a> must be supported for legacy reasons. Specifications are strongly advised not to make use of the <a class=idl-code data-link-type=interface href=#dom-legacydomrectlist title=legacydomrectlist>LegacyDOMRectList</a> interface and use Sequences <a data-biblio-type=normative data-link-type=biblio href=#biblio-webidl title=biblio-webidl>[WEBIDL]</a> instead.</strong>
334+
<strong class=advisement><a class=idl-code data-link-type=interface href=#dom-domrectlist title=domrectlist>DOMRectList</a> must be supported for legacy reasons. Specifications are strongly advised not to make use of the <a class=idl-code data-link-type=interface href=#dom-domrectlist title=domrectlist>DOMRectList</a> interface and use Sequences <a data-biblio-type=normative data-link-type=biblio href=#biblio-webidl title=biblio-webidl>[WEBIDL]</a> instead.</strong>
334335

335336
<h2 class="heading settled heading" data-level=5 id=DOMQuad><span class=secno>5 </span><span class=content>
336337
The DOMQuad interface</span><a class=self-link href=#DOMQuad></a></h2>
@@ -898,7 +899,7 @@ <h3 class="heading settled heading" data-level=6.3 id=immutable-transformation-m
898899
<dt><dfn class=idl-code data-dfn-for=DOMMatrixReadOnly data-dfn-type=method data-export="" id=dom-dommatrixreadonly-transformpoint title=transformPoint()>transformPoint(<var>point</var>)<a class=self-link href=#dom-dommatrixreadonly-transformpoint></a></dfn></dt>
899900
<dd>
900901
The point argument is post-multiplied to the current matrix and returns the resulting point. The passed argument does not get modified.
901-
<p class=note>Note: Even though <a class=idl-code data-link-type=attribute href=#dom-dommatrixreadonly-is2d title=is2d>is2D</a> of the current matrix may return <span class=css data-link-type=maybe title=true>true</span>, a 4x4 matrix mutliplication must be performed if the <a class=idl-code data-link-type=attribute href=#dom-dompointreadonly-dompoint-z title=z>z</a> attribute of <var>point</var> is not <span class=css data-link-type=maybe title=0>0</span> or the <a class=idl-code data-link-type=attribute href=#dom-dompointreadonly-dompoint-w title=w>w</a> attribute of <var>point</var> is not <span class=css data-link-type=maybe title=1>1</span>.</p>
902+
<p class=note>Note: Even though <a class=idl-code data-link-type=attribute href=#dom-dommatrixreadonly-is2d title=is2d>is2D</a> of the current matrix may return <span class=css data-link-type=maybe title=true>true</span>, a 4x4 matrix multiplication must be performed if the <a class=idl-code data-link-type=attribute href=#dom-dompointreadonly-dompoint-z title=z>z</a> attribute of <var>point</var> is not <span class=css data-link-type=maybe title=0>0</span> or the <a class=idl-code data-link-type=attribute href=#dom-dompointreadonly-dompoint-w title=w>w</a> attribute of <var>point</var> is not <span class=css data-link-type=maybe title=1>1</span>.</p>
902903
</dd>
903904
<dt><dfn class=idl-code data-dfn-for=DOMMatrixReadOnly data-dfn-type=method data-export="" id=dom-dommatrixreadonly-tofloat32array>toFloat32Array()<a class=self-link href=#dom-dommatrixreadonly-tofloat32array></a></dfn></dt>
904905
<dd>
@@ -1263,6 +1264,7 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
12631264
<li>DOMRect, <a href=#dom-domrect title="section 3">3</a>
12641265
<li>DOMRect(), <a href=#dom-domrect-domrect title="section 3">3</a>
12651266
<li>DOMRectInit, <a href=#dictdef-domrectinit title="section 3">3</a>
1267+
<li>DOMRectList, <a href=#dom-domrectlist title="section 4">4</a>
12661268
<li>DOMRectReadOnly(), <a href=#dom-domrect-domrectreadonly title="section 3">3</a>
12671269
<li>DOMRectReadOnly, <a href=#dom-domrectreadonly title="section 3">3</a>
12681270
<li>e, <a href=#dom-dommatrix-dommatrixreadonly-e title="section 6.2">6.2</a>
@@ -1273,16 +1275,15 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
12731275
<li>dict-member for DOMRectInit, <a href=#dom-domrectinit-height title="section 3">3</a>
12741276
<li>attribute for DOMRectReadOnly, DOMRect, <a href=#dom-domrectreadonly-domrect-height title="section 3">3</a>
12751277
</ul><li>height dimension, <a href=#height-dimension title="section 3">3</a>
1276-
<li>index, <a href=#dom-legacydomrectlistitem-index title="section 4">4</a>
1278+
<li>index, <a href=#dom-domrectlistitem-index title="section 4">4</a>
12771279
<li>inverse(), <a href=#dom-dommatrixreadonly-inverse title="section 6.3">6.3</a>
12781280
<li>invertSelf(), <a href=#dom-dommatrix-invertself title="section 6.4">6.4</a>
12791281
<li>is2D<ul><li>attribute for DOMMatrixReadOnly, <a href=#dom-dommatrixreadonly-is2d title="section 6.2">6.2</a>
12801282
<li>definition of, <a href=#is2d title="section 6.2">6.2</a>
12811283
</ul><li>isIdentity, <a href=#dom-dommatrixreadonly-isidentity title="section 6.2">6.2</a>
1282-
<li>item(), <a href=#dom-legacydomrectlist-item title="section 4">4</a>
1284+
<li>item(), <a href=#dom-domrectlist-item title="section 4">4</a>
12831285
<li>left, <a href=#dom-domrectreadonly-domrect-left title="section 3">3</a>
1284-
<li>LegacyDOMRectList, <a href=#dom-legacydomrectlist title="section 4">4</a>
1285-
<li>length, <a href=#dom-legacydomrectlist-length title="section 4">4</a>
1286+
<li>length, <a href=#dom-domrectlist-length title="section 4">4</a>
12861287
<li>m11, <a href=#dom-dommatrix-dommatrixreadonly-m11 title="section 6.2">6.2</a>
12871288
<li>m12, <a href=#dom-dommatrix-dommatrixreadonly-m12 title="section 6.2">6.2</a>
12881289
<li>m13, <a href=#dom-dommatrix-dommatrixreadonly-m13 title="section 6.2">6.2</a>

geometry/Overview.src.html

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -222,21 +222,22 @@ <h2 id='DOMRect'>
222222
For historical reasons, Window objects must also have a writable, configurable, non-enumerable property named <code>SVGRect</code> whose value is the <a interface>DOMRect</a> interface object.
223223

224224
<h2 id='DOMRectList'>
225-
The LegacyDOMRectList Interface</h2>
225+
The DOMRectList Interface</h2>
226226

227227
<pre class='idl'>
228-
[ArrayClass]
229-
interface LegacyDOMRectList {
228+
[NoInterfaceObject,
229+
ArrayClass]
230+
interface DOMRectList {
230231
readonly attribute unsigned long length;
231232
getter DOMRect? item(unsigned long index);
232233
};
233234
</pre>
234235

235-
The <dfn dfn-type=attribute dfn-for='LegacyDOMRectList'>length</dfn> attribute must return the total number of <a interface>DOMRect</a> objects associated with the object.
236+
The <dfn dfn-type=attribute dfn-for='DOMRectList'>length</dfn> attribute must return the total number of <a interface>DOMRect</a> objects associated with the object.
236237

237-
The <dfn dfn-type=method dfn-for='LegacyDOMRectList'>item(<var>index</var>)</dfn> method, when invoked, must return a ''null'' value when <var>index</var> is greater than or equal to the number of <a interface>DOMRect</a> objects associated with the <a interface>LegacyDOMRectList</a>. Otherwise, the <a interface>DOMRect</a> object at <var>index</var> must be returned.
238+
The <dfn dfn-type=method dfn-for='DOMRectList'>item(<var>index</var>)</dfn> method, when invoked, must return a ''null'' value when <var>index</var> is greater than or equal to the number of <a interface>DOMRect</a> objects associated with the <a interface>DOMRectList</a>. Otherwise, the <a interface>DOMRect</a> object at <var>index</var> must be returned. Indices are zero-based.
238239

239-
ADVISEMENT: <a interface>LegacyDOMRectList</a> must be supported for legacy reasons. Specifications are strongly advised not to make use of the <a interface>LegacyDOMRectList</a> interface and use Sequences [[!WEBIDL]] instead.
240+
ADVISEMENT: <a interface>DOMRectList</a> must be supported for legacy reasons. Specifications are strongly advised not to make use of the <a interface>DOMRectList</a> interface and use Sequences [[!WEBIDL]] instead.
240241

241242
<h2 id='DOMQuad'>
242243
The DOMQuad interface</h2>
@@ -806,7 +807,7 @@ <h3 id='immutable-transformation-methods'>Immutable transformation methods</h3>
806807
<dt><dfn>transformPoint(<var>point</var>)</dfn></dt>
807808
<dd>
808809
The point argument is post-multiplied to the current matrix and returns the resulting point. The passed argument does not get modified.
809-
<p class='note'>Note: Even though <a attribute>is2D</a> of the current matrix may return ''true'', a 4x4 matrix mutliplication must be performed if the <a attribute>z</a> attribute of <var>point</var> is not ''0'' or the <a attribute>w</a> attribute of <var>point</var> is not ''1''.</p>
810+
<p class='note'>Note: Even though <a attribute>is2D</a> of the current matrix may return ''true'', a 4x4 matrix multiplication must be performed if the <a attribute>z</a> attribute of <var>point</var> is not ''0'' or the <a attribute>w</a> attribute of <var>point</var> is not ''1''.</p>
810811
</dd>
811812
<dt><dfn>toFloat32Array()</dfn></dt>
812813
<dd>

geometry/issues-lc-2014.html

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,45 @@ <h1>Geometry Interfaces Module Level 1 Disposition of Comments for 2014-06-26 LC
3030
<p>An issue can be closed as <code>Accepted</code>, <code>OutOfScope</code>,
3131
<code>Invalid</code>, <code>Rejected</code>, or <code>Retracted</code>.
3232
<code>Verified</code> indicates commentor's acceptance of the response.</p>
33+
<pre class='open' id='issue-1'>
34+
Issue 1. <a href="#issue-1">#</a>
35+
Summary: Mark DOMRectList as legacy claerly; Make it NoInterfaceObject
36+
From: Anne van Kesteren
37+
Comment: <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=26200#c4">https://www.w3.org/Bugs/Public/show_bug.cgi?id=26200#c4</a>
38+
Open
39+
</pre>
40+
<pre class='open' id='issue-2'>
41+
Issue 2. <a href="#issue-2">#</a>
42+
Summary: Constructors for readonly interfaces; Add description of internal states
43+
From: Domenic Denicola
44+
Comment: <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=26201">https://www.w3.org/Bugs/Public/show_bug.cgi?id=26201</a>
45+
Open
46+
</pre>
47+
<pre class='open' id='issue-3'>
48+
Issue 3. <a href="#issue-3">#</a>
49+
Summary: Add pseudoinverse() method (a.k.a. Moore-Penrose inverse)
50+
From: Adenilson Cavalcanti
51+
Comment: <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=26375#c0">https://www.w3.org/Bugs/Public/show_bug.cgi?id=26375#c0</a>
52+
Open
53+
</pre>
54+
<pre class='open' id='issue-4'>
55+
Issue 4. <a href="#issue-4">#</a>
56+
Summary: Don't rename DOMRectList; It is implemented in two UAs
57+
From: Ms2ger
58+
Comment: <a href="http://lists.w3.org/Archives/Public/public-fx/2014JulSep/0025.html">http://lists.w3.org/Archives/Public/public-fx/2014JulSep/0025.html</a>
59+
Open
60+
</pre>
61+
<pre class='a' id='issue-5'>
62+
Issue 5. <a href="#issue-5">#</a>
63+
Summary: Calrify that DOMRectList is zero-based
64+
From: Adenilson Cavalcanti
65+
Comment: <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=26346">https://www.w3.org/Bugs/Public/show_bug.cgi?id=26346</a>
66+
Response: <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=26201#c5">https://www.w3.org/Bugs/Public/show_bug.cgi?id=26201#c5</a>
67+
Closed: Accepted
68+
</pre>
69+
<pre class='open' id='issue-6'>
70+
Issue 6. <a href="#issue-6">#</a>
71+
Summary: Detailed description of the used inverse algorithm on DOMMatrix
72+
From: Adenilson Cavalcanti
73+
Comment: <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=26374">https://www.w3.org/Bugs/Public/show_bug.cgi?id=26374</a>
74+
Open</pre>

geometry/issues-lc-2014.txt

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,40 @@
11
Draft: http://www.w3.org/TR/2014/WD-geometry-1-20140626/
22
Title: Geometry Interfaces Module Level 1
33

4-
----
4+
----
5+
Issue 1.
6+
Summary: Mark DOMRectList as legacy claerly; Make it NoInterfaceObject
7+
From: Anne van Kesteren
8+
Comment: https://www.w3.org/Bugs/Public/show_bug.cgi?id=26200#c4
9+
Open
10+
----
11+
Issue 2.
12+
Summary: Constructors for readonly interfaces; Add description of internal states
13+
From: Domenic Denicola
14+
Comment: https://www.w3.org/Bugs/Public/show_bug.cgi?id=26201
15+
Open
16+
----
17+
Issue 3.
18+
Summary: Add pseudoinverse() method (a.k.a. Moore-Penrose inverse)
19+
From: Adenilson Cavalcanti
20+
Comment: https://www.w3.org/Bugs/Public/show_bug.cgi?id=26375#c0
21+
Open
22+
----
23+
Issue 4.
24+
Summary: Don't rename DOMRectList; It is implemented in two UAs
25+
From: Ms2ger
26+
Comment: http://lists.w3.org/Archives/Public/public-fx/2014JulSep/0025.html
27+
Open
28+
----
29+
Issue 5.
30+
Summary: Calrify that DOMRectList is zero-based
31+
From: Adenilson Cavalcanti
32+
Comment: https://www.w3.org/Bugs/Public/show_bug.cgi?id=26346
33+
Response: https://www.w3.org/Bugs/Public/show_bug.cgi?id=26201#c5
34+
Closed: Accepted
35+
----
36+
Issue 6.
37+
Summary: Detailed description of the used inverse algorithm on DOMMatrix
38+
From: Adenilson Cavalcanti
39+
Comment: https://www.w3.org/Bugs/Public/show_bug.cgi?id=26374
40+
Open

0 commit comments

Comments
 (0)