cleanup getBoundingClientRect and getClientRects

Author: annevk

cssom/Overview.html

@@ -2329,11 +2329,11 @@ <h3 id=the-elementlayout><span class=secno>4.3. </span>The <code><a
   <a href="#textrectanglelist">TextRectangleList</a> <a href="#elementlayout-getclientrects">getClientRects</a>();
   <a href="#textrectangle">TextRectangle</a> <a href="#elementlayout-getboundingclientrect">getBoundingClientRect</a>();
 
+  readonly attribute Element <a href="#elementlayout-offsetparent">offsetParent</a>;
   readonly attribute float <a href="#elementlayout-offsettop">offsetTop</a>;
   readonly attribute float <a href="#elementlayout-offsetleft">offsetLeft</a>;
   readonly attribute float <a href="#elementlayout-offsetwidth">offsetWidth</a>;
   readonly attribute float <a href="#elementlayout-offsetheight">offsetHeight</a>;
-  readonly attribute HTMLElement <a href="#elementlayout-offsetparent">offsetParent</a>; // HTMLElement
 
            attribute float <a href="#elementlayout-scrolltop">scrollTop</a>;    // scroll on setting
            attribute float <a href="#elementlayout-scrollleft">scrollLeft</a>;   // scroll on setting
@@ -2356,43 +2356,56 @@ <h4 id=the-getclientrects><span class=secno>4.3.1. </span>The <code><a
  multiple boxes it's the amount of boxes. -->
 
   <p>The <dfn
-   id=elementlayout-getclientrects><code>getClientRects()</code></dfn> method
-   <em class=ct>must</em>, when invoked, return a <code><a
-   href="#textrectanglelist">TextRectangleList</a></code> object containing a
-   list of <code><a href="#textrectangle">TextRectangle</a></code> objects
-   describing the border boxes for the element on which it was invoked.
+   id=elementlayout-getclientrects><code>getClientRects()</code></dfn>
+   method, when invoked, <em class=ct>must</em> return the result of the
+   following algorithm:
+
+  <ol>
+   <li>
+    <p>If the element on which it was invoked does not have an associated CSS
+     layout box return an empty (static) <code><a
+     href="#textrectanglelist">TextRectangleList</a></code> object and stop
+     this algorithm.
+
+   <li>
+    <p>Return a (static) <code><a
+     href="#textrectanglelist">TextRectangleList</a></code> object containing
+     a list of (static) <code><a
+     href="#textrectangle">TextRectangle</a></code> objects describing the
+     border boxes for the element (in content order) on which it was invoked.
+  </ol>
 
   <p>The <dfn
    id=elementlayout-getboundingclientrect><code>getBoundingClientRect()</code></dfn>
-   method <em class=ct>must</em>, when invoked, return a union of the
-   rectangles returned by <code><a
-   href="#elementlayout-getclientrects">getClientRects()</a></code> in a
-   single <code><a href="#textrectangle">TextRectangle</a></code> object for
-   the element on which it was invoked.
-
-  <p>The values of the attributes of the <code><a
-   href="#textrectangle">TextRectAngle</a></code> object <em
-   class=ct>must</em> all be expressed in CSS pixels. They are all relative
-   to the top left corner of the canvas (0, 0) and calculated as if nothing
-   has been scrolled. If the element is a descendent of an
-   <code>svg:foreignObject</code> element the dimensions are measured
-   relative to the origin of the nearest <code>svg:foreignObject</code>
-   ancestor, in the <code>svg:foreignObject</code> subtree's CSS coordinate
-   system.
-
-  <p class=issue>...</p>
+   method, when invoked, <em class=ct>must</em> return the result of the
+   following algorithm:
+
+  <ol>
+   <li>
+    <p>If the element on which it was invoked does not have an associated CSS
+     layout box return a (static) <code><a
+     href="#textrectangle">TextRectangle</a></code> object whose <code
+     title=textrectangle-top><a href="#textrectangle-top">top</a></code>,
+     <code title=textrectangle-right><a
+     href="#textrectangle-right">right</a></code>, <code
+     title=textrectangle-bottom><a
+     href="#textrectangle-bottom">bottom</a></code> and <code
+     title=textrectangle-left><a href="#textrectangle-left">left</a></code>
+     members are zero.
+
+   <li>
+    <p>Return a union of the rectangles returned by <code><a
+     href="#elementlayout-getclientrects">getClientRects()</a></code> method
+     as a single <code><a href="#textrectangle">TextRectangle</a></code>
+     object for the element on which it was invoked.
+  </ol>
   <!--
    XXX
 
    - The returned rectangles do not include the bounds of any child elements
    that might happen to overflow (ok, this was not ambiguous in the above
    definition, it's just a note)
 
-   - For HTML AREA elements, SVG elements that do not render anything
-   themselves, display:none elements, and generally any elements that are not
-   directly rendered, we return an empty list or a (0,0,0,0) rect (arguably this
-   also follows from the definition)
-
    - for getClientRects we return rectangles even for CSS boxes that have empty
    border-boxes. The left, top, right and bottom coordinates can still be
    meaningful.
@@ -2456,23 +2469,27 @@ <h5 id=the-textrectangle><span class=secno>4.3.1.2. </span>The <code><a
 
   <p>The <dfn id=textrectangle-top
    title=textrectangle-top><code>top</code></dfn> attribute, on getting, <em
-   class=ct>must</em> return the distance between the top of the viewport and
-   the top of the rectangle box.
+   class=ct>must</em> return the distance between the top of the initial
+   containing block and the top of the rectangle box in CSS pixels as number
+   of CSS pixels assuming nothing has been scrolled.
 
   <p>The <dfn id=textrectangle-right
    title=textrectangle-right><code>right</code></dfn> attribute, on getting,
-   <em class=ct>must</em> return the distance between the left of the
-   viewport and the right of the rectangle box.
+   <em class=ct>must</em> return the distance between the left of the initial
+   containing block and the right of the rectangle box in CSS pixels as
+   number of CSS pixels assuming nothing has been scrolled.
 
   <p>The <dfn id=textrectangle-bottom
    title=textrectangle-bottom><code>bottom</code></dfn> attribute, on
    getting, <em class=ct>must</em> return the distance between the top of the
-   viewport and the bottom of the rectangle box.
+   initial containing block and the bottom of the rectangle box in CSS pixels
+   as number of CSS pixels assuming nothing has been scrolled.
 
   <p>The <dfn id=textrectangle-left
    title=textrectangle-left><code>left</code></dfn> attribute, on getting,
-   <em class=ct>must</em> return the distance between the left of the
-   viewport and the left of the rectangle box.
+   <em class=ct>must</em> return the distance between the left of the initial
+   containing block and the left of the rectangle box in CSS pixels as number
+   of CSS pixels assuming nothing has been scrolled.
 
   <h4 id=the-offset><span class=secno>4.3.2. </span>The <code
    title="">offset<var title="">*</var></code> attributes</h4>

cssom/Overview.src.html

@@ -1920,11 +1920,11 @@ <h3>The <code>ElementLayout</code> Interface</h3>
   <span>TextRectangleList</span> <span>getClientRects</span>();
   <span>TextRectangle</span> <span>getBoundingClientRect</span>();
 
+  readonly attribute Element <span>offsetParent</span>;
   readonly attribute float <span>offsetTop</span>;
   readonly attribute float <span>offsetLeft</span>;
   readonly attribute float <span>offsetWidth</span>;
   readonly attribute float <span>offsetHeight</span>;
-  readonly attribute HTMLElement <span>offsetParent</span>; // HTMLElement
 
            attribute float <span>scrollTop</span>;    // scroll on setting
            attribute float <span>scrollLeft</span>;   // scroll on setting
@@ -1946,26 +1946,36 @@ <h4>The <code>getClientRects()</code> and <code>getBoundingClientRect</code>
 
   <p>The
   <dfn id="elementlayout-getclientrects"><code>getClientRects()</code></dfn>
-  method <em class="ct">must</em>, when invoked, return a
-  <code>TextRectangleList</code> object containing a list of
-  <code>TextRectangle</code> objects describing the border boxes for the element
-  on which it was invoked.</p>
+  method, when invoked, <em class="ct">must</em> return the result of the
+  following algorithm:</p>
+  
+  <ol>
+   <li><p>If the element on which it was invoked does not have an associated CSS
+   layout box return an empty (static) <code>TextRectangleList</code> object and
+   stop this algorithm.</p></li>
+  
+   <li><p>Return a (static) <code>TextRectangleList</code> object containing a
+   list of (static) <code>TextRectangle</code> objects describing the border
+   boxes for the element (in content order) on which it was invoked.</p></li>
+  </ol>
 
   <p>The
   <dfn id="elementlayout-getboundingclientrect"><code>getBoundingClientRect()</code></dfn>
-  method <em class="ct">must</em>, when invoked, return a union of the
-  rectangles returned by <code>getClientRects()</code> in a single
-  <code>TextRectangle</code> object for the element on which it was invoked.</p>
-
-  <p>The values of the attributes of the <code>TextRectAngle</code> object
-  <em class="ct">must</em> all be expressed in CSS pixels. They are all relative
-  to the top left corner of the canvas (0, 0) and calculated as if nothing has
-  been scrolled. If the element is a descendent of an
-  <code>svg:foreignObject</code> element the dimensions are measured relative to
-  the origin of the nearest <code>svg:foreignObject</code> ancestor, in the
-  <code>svg:foreignObject</code> subtree's CSS coordinate system.</p>
-
-  <p class="issue">...</p>
+  method, when invoked, <em class="ct">must</em> return the result of the
+  following algorithm:</p>
+  
+  <ol>
+   <li><p>If the element on which it was invoked does not have an associated CSS
+   layout box return a (static) <code>TextRectangle</code> object whose
+   <code title="textrectangle-top">top</code>,
+   <code title="textrectangle-right">right</code>,
+   <code title="textrectangle-bottom">bottom</code> and
+   <code title="textrectangle-left">left</code> members are zero.</p></li>
+   
+   <li><p>Return a union of the rectangles returned by
+   <code>getClientRects()</code> method as a single <code>TextRectangle</code>
+   object for the element on which it was invoked.</p></li>
+  </ol>
 
   <!--
    XXX
@@ -1974,11 +1984,6 @@ <h4>The <code>getClientRects()</code> and <code>getBoundingClientRect</code>
    that might happen to overflow (ok, this was not ambiguous in the above
    definition, it's just a note)
 
-   - For HTML AREA elements, SVG elements that do not render anything
-   themselves, display:none elements, and generally any elements that are not
-   directly rendered, we return an empty list or a (0,0,0,0) rect (arguably this
-   also follows from the definition)
-
    - for getClientRects we return rectangles even for CSS boxes that have empty
    border-boxes. The left, top, right and bottom coordinates can still be
    meaningful.
@@ -2030,27 +2035,30 @@ <h5>The <code>TextRectangle</code> Interface</h5>
   readonly attribute float <span title="textrectangle-bottom">bottom</span>;
   readonly attribute float <span title="textrectangle-left">left</span>;
 };</pre>
-  
+
   <p>The
   <dfn id="textrectangle-top" title="textrectangle-top"><code>top</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the distance between
-  the top of the viewport and the top of the rectangle box.</p>
+  the top of the initial containing block and the top of the rectangle box in
+  CSS pixels as number of CSS pixels assuming nothing has been scrolled.</p>
 
   <p>The
   <dfn id="textrectangle-right" title="textrectangle-right"><code>right</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the distance between
-  the left of the viewport and the right of the rectangle box.</p>
-  
+  the left of the initial containing block and the right of the rectangle box in
+  CSS pixels as number of CSS pixels assuming nothing has been scrolled.</p>
+
   <p>The
   <dfn id="textrectangle-bottom" title="textrectangle-bottom"><code>bottom</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the distance between
-  the top of the viewport and the bottom of the rectangle box.</p>
-
+  the top of the initial containing block and the bottom of the rectangle box in
+  CSS pixels as number of CSS pixels assuming nothing has been scrolled.</p>
 
   <p>The
   <dfn id="textrectangle-left" title="textrectangle-left"><code>left</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the distance between
-  the left of the viewport and the left of the rectangle box.</p>
+  the left of the initial containing block and the left of the rectangle box in
+  CSS pixels as number of CSS pixels assuming nothing has been scrolled.</p>