Modified region layout event to be dispatched on NamedFlow instead of region as before. Was requested by Issue 15938 and required in the general effort to have the DOM APIs work with non-element regions

--HG--
extra : rebase_source : 4c504e1d7050a9f1fee5de434a8564c8d4c526da

Author: vhardy

css3-regions/Overview.html

@@ -2073,12 +2073,15 @@ <h3 id=the-namedflow-interface><span class=secno>7.1. </span>The NamedFlow
   </div>
 
   <pre class=idl>
-interface <a href="#dom-namedflow">NamedFlow</a> {
+interface <a
+   href="#dom-namedflow">NamedFlow</a> implements <a
+   href="http://www.w3.org/TR/dom/#interface-eventtarget">EventTarget</a> {
   readonly attribute DOMString name;
   readonly attribute boolean <a
    href="#dom-namedflow-overset">overset</a>;
   sequence&lt;<a
    href="#region-interface">Region</a>&gt; getRegions();
+  readonly attribute integer emptyRegionsIndex;
   <a
    href="http://www.w3.org/TR/dom/#interface-nodelist">NodeList</a> getContent();
   sequence&lt;<a
@@ -2100,6 +2103,16 @@ <h3 id=the-namedflow-interface><span class=secno>7.1. </span>The NamedFlow
    href="#named-flow0">named flow</a>. Note that the returned values is a
    static sequence.
 
+  <p>The <dfn id=dom-namedflow-unusedregionindex>emptyRegionsIndex</dfn> is
+   the index of the first region in the region sequence with the <a
+   href="#dom-region-regionoverset"><code>regionOverset</code></a> attribute
+   set to <code>empty</code>. If all regions have the <a
+   href="#dom-region-regionoverset"><code>regionOverset</code></a> attribute
+   set to <code>fit</code> or <a
+   href="#dom-namedflow-overset"><code>overset</code></a>, the value for <a
+   href="#dom-namedflow-unusedregionindex"><code>emptyRegionsIndex</code></a>
+   is <code>-1</code>.
+
   <p>The <dfn id=dom-namedflow-getcontent>getContent()</dfn> methods returns
    an ordered collection of nodes that constitute the named flow. The
    returned list is a static snapshot of the named flow content at the time
@@ -2239,9 +2252,10 @@ <h3 id=region-flow-layout-events><span class=secno>7.3. </span>Region flow
    </div>
   </div>
 
-  <p>Region <a href="">Event Targets</a> dispatch <code
+  <p><a href="#dom-namedflow"><code class=idl>NamedFlow</code></a> objects
+   are <a href="">Event Targets</a> which dispatch <code
    class=idl>regionLayoutUpdate</code> events when there is a possible layout
-   change of their named flow segment.
+   change of their named flow segment. Note how the event is asynchronous.
 
   <table border=0 cellpadding=2 cellspacing=0 class=event-desc
    summary="This table contains information about the semantics of the given event type">
@@ -2255,8 +2269,8 @@ <h3 id=region-flow-layout-events><span class=secno>7.3. </span>Region flow
      <th>Interface
 
      <td><code><a
-      href="http://www.w3.org/TR/DOM-Level-3-Events/#webidl-events-UIEvent">UIEvent</a></code>(see
-      <a href="#DOM-LEVEL-3-EVENTS"
+      href="http://www.w3.org/TR/DOM-Level-3-Events/#webidl-events-UIEvent">UIEvent</a></code>
+      (see <a href="#DOM-LEVEL-3-EVENTS"
       rel=biblioentry>[DOM-LEVEL-3-EVENTS]<!--{{!DOM-LEVEL-3-EVENTS}}--></a>)
 
     <tr class="assert must">
@@ -2272,7 +2286,7 @@ <h3 id=region-flow-layout-events><span class=secno>7.3. </span>Region flow
     <tr class="assert must">
      <th>Target
 
-     <td><code>Element</code>
+     <td><a href="#dom-namedflow"><code class=idl>NamedFlow</code></a>
 
     <tr class="assert must">
      <th>Cancelable
@@ -2289,7 +2303,8 @@ <h3 id=region-flow-layout-events><span class=secno>7.3. </span>Region flow
 
      <td>
       <ul>
-       <li><code class=attribute-name>Event.target</code>: region whose
+       <li><code class=attribute-name>Event.target</code>: <a
+        href="#dom-namedflow"><code class=idl>NamedFlow</code></a> whose
         layout may have changed
       </ul>
   </table>
@@ -2439,6 +2454,13 @@ <h3 id="changes_from_June_09_2011"><span class=secno>11.1. </span>Changes
       href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=16286">Issue
       16286</a>)
     </ul>
+
+   <li>Modified region layout event to be dispatched on <a
+    href="#dom-namedflow"><code>NamedFlow</code></a> instead of region as
+    before. Was requested by <a
+    href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15938">Issue
+    15938</a> and required in the general effort to have the DOM APIs work
+    with non-element regions.
   </ul>
 
   <h3 id="changes_from_June_09_2011"><span class=secno>11.2. </span>Changes
@@ -2936,6 +2958,9 @@ <h2 class=no-num id=index>Index</h2>
    <li>current-region, <a href="#current-region"
     title=current-region><strong>2.3.</strong></a>
 
+   <li>emptyRegionsIndex, <a href="#dom-namedflow-unusedregionindex"
+    title=emptyRegionsIndex><strong>7.1.</strong></a>
+
    <li>flowFrom, <a href="#dom-region-flowfrom"
     title=flowFrom><strong>7.2.</strong></a>
 

css3-regions/Overview.src.html

@@ -1798,10 +1798,11 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
     </div>
 
     <pre class="idl">
-interface <a href="#dom-namedflow">NamedFlow</a> {
+interface <a href="#dom-namedflow">NamedFlow</a> implements <a href="http://www.w3.org/TR/dom/#interface-eventtarget">EventTarget</a> {
   readonly attribute DOMString name;
   readonly attribute boolean <a href="#dom-namedflow-overset">overset</a>;
   sequence&lt;<a href="#region-interface">Region</a>&gt; getRegions();
+  readonly attribute integer emptyRegionsIndex;
   <a href="http://www.w3.org/TR/dom/#interface-nodelist">NodeList</a> getContent();
   sequence&lt;<a href="#region-interface">Region</a>&gt; getRegionsByContent(<a href="http://www.w3.org/TR/dom/#interface-node">Node</a> node);
 };</pre>
@@ -1817,6 +1818,12 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
     method returns the sequence of regions in the <span>region chain</span> associated
     with the <span>named flow</span>. Note that the returned values is a static sequence.</p>
 
+    <p>The <dfn id="dom-namedflow-unusedregionindex">emptyRegionsIndex</dfn> is the index
+        of the first region in the region sequence with the <code>regionOverset</code> attribute
+        set to <code>empty</code>. If all regions have the <code>regionOverset</code> attribute
+        set to <code>fit</code> or <code>overset</code>, the value for 
+        <code>emptyRegionsIndex</code> is <code>-1</code>.</p>
+        
     <p>The <dfn id="dom-namedflow-getcontent">getContent()</dfn> methods returns 
         an ordered collection of nodes that constitute the named flow. The returned list
         is a static snapshot of the named flow content at the time the method is invoked.
@@ -1935,22 +1942,24 @@ <h3 id="region-flow-layout-events">Region flow layout events</h3>
         </div>
     </div>
 
-    <p>Region <a href="">Event Targets</a> 
-    dispatch <code class="idl">regionLayoutUpdate</code> events when there is a possible layout change of their named flow segment.</p>
+    <p><a href="#dom-namedflow"><code class="idl">NamedFlow</code></a> objects are
+     <a href="">Event Targets</a> which
+    dispatch <code class="idl">regionLayoutUpdate</code> events when there is a possible layout change of their named flow segment. Note how the event is asynchronous.</p>
 
     <table class="event-desc" border="0" summary="This table contains information about the semantics of the given event type" cellpadding="2" cellspacing="0">
                 <tbody><tr class="assert must"><th>Type</th>
                 <td class="eventname"><strong><code>regionLayoutUpdate</code></strong></td></tr>
-                <tr class="assert must"><th>Interface</th> <td><code><a href="http://www.w3.org/TR/DOM-Level-3-Events/#webidl-events-UIEvent">UIEvent</a></code>(see [[!DOM-LEVEL-3-EVENTS]])</td></tr>
+                <tr class="assert must"><th>Interface</th> <td><code><a href="http://www.w3.org/TR/DOM-Level-3-Events/#webidl-events-UIEvent">UIEvent</a></code> (see [[!DOM-LEVEL-3-EVENTS]])</td></tr>
                 <tr class="assert must"><th>Sync / Async</th> <td>Async</td></tr>
                 <tr class="assert must"><th>Bubbles</th> <td>Yes</td></tr>
-                <tr class="assert must"><th>Target</th> <td><code>Element</code></td></tr>
+                <tr class="assert must"><th>Target</th> <td><a href="#dom-namedflow"><code class="idl">NamedFlow</code></a></td></tr>
                 <tr class="assert must"><th>Cancelable</th> <td>Yes</td></tr>
                 <tr class="assert must"><th>Default action</th> <td>none</td></tr>
                 <tr class="assert must"><th>Context info</th>
                   <td>
                     <ul>
-                      <li><code class="attribute-name">Event.target</code>: region whose layout may have changed</li>
+                      <li><code class="attribute-name">Event.target</code>: 
+                          <a href="#dom-namedflow"><code class="idl">NamedFlow</code></a> whose layout may have changed</li>
                     </ul>
                    </td>
                  </tr>
@@ -2033,6 +2042,9 @@ <h3 id="changes_from_June_09_2011">Changes from <a href="http://www.w3.org/TR/20
 
             </ul>
         </li>
+        <li>Modified region layout event to be dispatched on <code>NamedFlow</code> instead of region 
+            as before. Was requested by <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15938">Issue 15938</a>
+            and required in the general effort to have the DOM APIs work with non-element regions.</li>
     </ul>