Added section about getClientRects(), getBoundingClientRect(), offsetWidth, offsetHeight, offsetTop and offsetLeft

--HG--
extra : rebase_source : a9761d3044d92f816ce84f7895fe714fe18f3442

Author: vhardy

css3-regions/Overview.html

@@ -425,6 +425,20 @@ <h2 class="no-num no-toc" id=table-of-contents>Table of contents</h2>
 
      <li><a href="#region-flow-layout-events"><span class=secno>7.3.
       </span>Region flow layout events</a>
+
+     <li><a href="#cssomview-and-regions"><span class=secno>7.4. </span>CSS
+      OM View and CSS Regions</a>
+      <ul class=toc>
+       <li><a
+        href="#cssomview-getclientrects-and-getboundingclientrect"><span
+        class=secno>7.4.1. </span><code class=idl>getClientRects()</code> and
+        <code>getBoundingClientRects()</code></a>
+
+       <li><a href="#cssomview-offset-attributes"><span class=secno>7.4.2.
+        </span><code class=idl>offsetTop</code>, <code
+        class=idl>offsetLeft</code>, <code class=idl>offsetWidth</code> and
+        <code class=idl>offsetWidth</code></a>
+      </ul>
     </ul>
 
    <li><a href="#relation-to-other-specifications"><span class=secno>8.
@@ -1921,14 +1935,6 @@ <h2 id="cssom_view_and_css_regions"><span class=secno>7. </span>CSSOM view
    be needed to accommodate for the additional space required to fit the
    larger text or some regions may need to be removed for smaller text.
 
-  <div class=note><span class=note-prefix>Note </span>
-   <p>Since an element may be split into multiple regions, invoking <code
-    class=idl><a
-    href="http://www.w3.org/TR/cssom-view/#dom-element-getclientrects">getClientRects</a></code>
-    on it must return the list of rectangles for the element in all the
-    regions it is part of.</p>
-  </div>
-
   <h3 id=the-namedflow-interface><span class=secno>7.1. </span>The NamedFlow
    interface</h3>
 
@@ -2305,6 +2311,40 @@ <h3 id=region-flow-layout-events><span class=secno>7.3. </span>Region flow
       </ul>
   </table>
 
+  <h3 id=cssomview-and-regions><span class=secno>7.4. </span>CSS OM View and
+   CSS Regions</h3>
+
+  <h4 id=cssomview-getclientrects-and-getboundingclientrect><span
+   class=secno>7.4.1. </span><code class=idl>getClientRects()</code> and
+   <code>getBoundingClientRects()</code></h4>
+
+  <p>The <a href="http://www.w3.org/TR/cssom-view/">CSSOM View Module</a>
+   defines how user agents compute the bounding client rectangle for an
+   element (<code class=idl>getBoundingClientRect()</code>) and its generated
+   boxes (<code class=idl>getClientRects()</code>).
+
+  <p>This definition applies to CSS regions and the multiple boxes generated
+   for an element flowing through multiple regions. The <code
+   class=idl>getClientRects()</code> method returns the list of boxes
+   generated for each of the element fragment laid out different regions. The
+   <code>getBoundingClientRect()</code> method operates as specified in the
+   <a href="http://www.w3.org/TR/cssom-view/">CSSOM View Module</a> as well
+   and is computed from the set of rectangles returned by <code
+   class=idl>getClientRects()</code>.
+
+  <h4 id=cssomview-offset-attributes><span class=secno>7.4.2. </span><code
+   class=idl>offsetTop</code>, <code class=idl>offsetLeft</code>, <code
+   class=idl>offsetWidth</code> and <code class=idl>offsetWidth</code></h4>
+
+  <p>The computation of the <a
+   href="http://dev.w3.org/csswg/cssom-view/#offset-attributes">offset
+   attributes</a> for elements laid out in a <span>named flow follow the <a
+   href="http://dev.w3.org/csswg/cssom-view/#offset-attribute">specification</a>.
+   For the purpose of the algorithm, the <em>first CSS layout box</em>
+   associated with an element laid out in a <a href="#named-flow0">named
+   flow</a> is the box generated for the first region the element is laid out
+   into.</span>
+
   <h2 id=relation-to-other-specifications><span class=secno>8.
    </span>Relation to other specifications</h2>
 
@@ -2464,6 +2504,9 @@ <h3 id="changes_from_June_09_2011"><span class=secno>11.1. </span>Changes
     class=css>::before</code>&rsquo; element (for a example) to a named flow
     does not seem useful and causes specification and implementation
     complexity.
+
+   <li>Added section about getClientRects(), getBoundingClientRect(),
+    offsetWidth, offsetHeight, offsetTop and offsetLeft.
   </ul>
 
   <h3 id="changes_from_June_09_2011"><span class=secno>11.2. </span>Changes

css3-regions/Overview.src.html

@@ -1675,13 +1675,6 @@ <h2 id="cssom_view_and_css_regions">CSSOM view and CSS regions</h2>
     regions may be needed to accommodate for the additional space required to
     fit the larger text or some regions may need to be removed for smaller text.</p>
 
-    <div class="note"><span class="note-prefix">Note </span>
-        <p>Since an element may be split into multiple regions, invoking
-        <code class="idl"><a href=
-        "http://www.w3.org/TR/cssom-view/#dom-element-getclientrects">getClientRects</a></code>
-        on it must return the list of rectangles for the element in all the
-        regions it is part of.</p>
-    </div>
     <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
 
     <p>A <span>named flow</span> is created when it becomes referenced by the 
@@ -1963,6 +1956,29 @@ <h3 id="region-flow-layout-events">Region flow layout events</h3>
                  </tr>
               </tbody></table>
 
+    <h3 id="cssomview-and-regions">CSS OM View and CSS Regions</h3>
+    
+    
+    <h4 id="cssomview-getclientrects-and-getboundingclientrect"><code class="idl">getClientRects()</code> and <code>getBoundingClientRects()</code></h4>
+    
+    <p>The <a href="http://www.w3.org/TR/cssom-view/">CSSOM View Module</a> defines how user agents compute the bounding client rectangle for an element (<code class="idl">getBoundingClientRect()</code>) and its generated boxes (<code class="idl">getClientRects()</code>).
+
+    <p>This definition applies to CSS regions and the multiple boxes generated for an element flowing 
+        through multiple regions. The <code class="idl">getClientRects()</code> method returns the list 
+        of boxes generated for each of the element fragment laid out different regions. 
+        The <code>getBoundingClientRect()</code> method operates as specified in the 
+        <a href="http://www.w3.org/TR/cssom-view/">CSSOM View Module</a> as well and is computed 
+        from the set of rectangles returned by <code class="idl">getClientRects()</code>.</p>
+
+    <h4 id="cssomview-offset-attributes"><code class="idl">offsetTop</code>, <code class="idl">offsetLeft</code>,
+        <code class="idl">offsetWidth</code> and <code class="idl">offsetWidth</code></h4>
+    
+    <p>The computation of the <a href="http://dev.w3.org/csswg/cssom-view/#offset-attributes">offset attributes</a> 
+        for elements laid out in a <span>named flow</code> follow the <a href="http://dev.w3.org/csswg/cssom-view/#offset-attribute">specification</a>. For the purpose of the 
+            algorithm, the <em>first CSS layout box</em> associated
+            with an element laid out in a <span>named flow</span> is the box generated for the first region
+            the element is laid out into.</p>
+        
     <h2 id="relation-to-other-specifications">Relation to other
     specifications</h2>
 
@@ -2046,6 +2062,8 @@ <h3 id="changes_from_June_09_2011">Changes from <a href="http://www.w3.org/TR/20
         <li>Changed paragraph on pseudo-elements to disallow 'flow-into' on all pseudo-elements because 
             moving a '::before' element (for a example) to a named flow does not seem useful and causes specification
             and implementation complexity.</li>
+        <li>Added section about getClientRects(), getBoundingClientRect(), offsetWidth, offsetHeight, offsetTop and
+            offsetLeft.</li>
     </ul>