[css-regions] restrict flow-from further, collection misses undefined->null

Author: astearns

css-regions/Overview.html

@@ -12,7 +12,7 @@
    rel=dcterms.rights>
   <meta content="CSS Regions Module Level 1" name=dcterms.title>
   <meta content=text name=dcterms.type>
-  <meta content=2013-07-03 name=dcterms.date>
+  <meta content=2013-07-10 name=dcterms.date>
   <meta content="Vincent Hardy" name=dcterms.creator>
   <meta content="Rossen Atanassov" name=dcterms.creator>
   <meta content="Alan Stearns" name=dcterms.creator>
@@ -43,7 +43,7 @@
 
    <h1 id=css-regions-module>CSS Regions Module Level 1</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 3 July 2013</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 10 July 2013</h2>
 
    <dl>
     <dt>This version:
@@ -858,7 +858,8 @@ <h3 id=the-flow-from-property><span class=secno>3.2. </span>The ‘<a
 
      <td>Non-replaced <a
       href="http://www.w3.org/TR/CSS21/visuren.html#block-boxes">block
-      containers</a>. <br>
+      containers</a> whose display property computes to block, inline-block
+      or table-cell. <br>
       This might be expanded in future versions of the specification to allow
       other types of containers to receive flow content.
 
@@ -955,20 +956,6 @@ <h3 id=the-flow-from-property><span class=secno>3.2. </span>The ‘<a
    selector is still associated with that empty <a href="#named-flow0">named
    flow</a> and, consequently, its children are not formatted visually.</div>
 
-  <div class=note><span class=note-prefix>Note </span>
-   <p>At the time of this note-writing, the <code>display</code> values that
-    always result in a non-replaced block container include
-    <code>block</code>, <code>inline-block</code>, <code>table-cell</code>,
-    <code>table-caption</code>, and <code>list-item</code>. All of these
-    display values work as regions with non-replaced elements.
-
-   <p>The <code>flex</code> and <code>grid</code> display values do not
-    result in block containers (they are defined as flex containers and grid
-    elements, respectively). So ‘<a href="#flow-from"><code
-    class=property>flow-from</code></a>’ combined with those display values
-    does not result in a CSS Region.
-  </div>
-
   <p><a href="#css-region" title=region>CSS Regions</a> create a new <a
    href="http://www.w3.org/TR/CSS2/visuren.html#z-index">stacking
    context</a>. <a href="#css-region" title=region>CSS Regions</a> establish
@@ -1811,7 +1798,7 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
   <p>The <dfn id=dom-named-flow-collection-item><code
    class=idl>item(index)</code></dfn> method returns the <a
    href="#dom-named-flow"><code>NamedFlow</code></a> instance at index
-   <em>index</em> in the collection or <code class=idl>undefined</code> if
+   <em>index</em> in the collection or <code class=idl>null</code> if
    <em>index</em> is out of range. An object <code>collection</code>
    implementing <a
    href="#dom-named-flow-collection"><code>NamedFlowCollection</code></a>
@@ -1823,7 +1810,7 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
    href="#dom-named-flow"><code>NamedFlow</code></a> instance in the
    collection whose name attribute matches the supplied <a
    href="#dom-named-flow-name"><em>name</em></a>, or <code
-   class=idl>undefined</code> if there is no match.
+   class=idl>null</code> if there is no match.
 
   <p>The <dfn id=dom-named-flow><code class=idl>NamedFlow</code></dfn>
    interface offers a representation of a <a href="#named-flow0">named
@@ -2852,6 +2839,11 @@ <h3 id="changes_from_May_28_2013"><span class=secno>12.1. </span>Changes
    28<sup>th</sup> 2013</a> version</h3>
 
   <ul>
+   <li>Changed NamedFlowCollection getters back to null when there is no
+    NamedFlow.
+
+   <li>Restricted flow-from to blocks, inline-blocks and table-cells
+
    <li>Removed issue on user events and added note describing solution(s)
 
    <li>Changed type of NamedFlow.getContent() from NodeList to
@@ -2948,15 +2940,15 @@ <h2 class=no-num id=acknowledgments>Acknowledgments</h2>
    for their contributions, either during the conception of CSS regions or
    during its development and specification review process:
 
-  <p>Rossen Atanassov, Tab Atkins, Mihai Balan, Andrei Bucur, Razvan Caliman,
-   Alexandru Chiculita, Phil Cupp, Arron Eicholz, John Jansen, Dimitri
-   Glazkov, Daniel Glazman, Arno Gourdol, David Hyatt, Brian Heuston, Ian
-   Hickson, Jonathan Hoersch, Michael Jolson, Brad Kemper, Håkon Wium Lie,
-   Kang-Hao (Kenny) Lu, Mihai Maerean, Markus Mielke, Robert O'Callahan,
-   Edward O'Connor, Mihnea Ovidenie, Virgil Palanciuc, Olga Popiv, Christoph
-   Päper, Anton Prowse, Peter Sorotokin, Elliott Sprehn, Christian
-   Stockwell, Eugene Veselov, Boris Zbarsky, Stephen Zilles and the CSS
-   Working Group members.
+  <p>Erik Arvidsson, Tab Atkins, Catalin Badea, Mihai Balan, Andrei Bucur,
+   Razvan Caliman, Alexandru Chiculita, Phil Cupp, Arron Eicholz, John
+   Jansen, Dimitri Glazkov, Daniel Glazman, Arno Gourdol, Catalin
+   Grigoroscuta, David Hyatt, Brian Heuston, Ian Hickson, Jonathan Hoersch,
+   Michael Jolson, Brad Kemper, Håkon Wium Lie, Kang-Hao (Kenny) Lu, Mihai
+   Maerean, Markus Mielke, Robert O'Callahan, Edward O'Connor, Mihnea
+   Ovidenie, Virgil Palanciuc, Olga Popiv, Christoph Päper, Anton Prowse,
+   Peter Sorotokin, Elliott Sprehn, Radu Stavila, Christian Stockwell, Eugene
+   Veselov, Boris Zbarsky, Stephen Zilles and the CSS Working Group members.
 
   <h2 class=no-num id=intro-example-code>Appendix A. Example Code for
    Introduction</h2>
@@ -3471,7 +3463,8 @@ <h2 class=no-num id=property-index>Property index</h2>
 
      <td>none
 
-     <td>Non-replaced block containers. This might be expanded in future
+     <td>Non-replaced block containers whose display property computes to
+      block, inline-block or table-cell. This might be expanded in future
       versions of the specification to allow other types of containers to
       receive flow content.
 

css-regions/Overview.src.html

@@ -671,7 +671,7 @@ <h3 id="the-flow-from-property">The 'flow-from' property</h3>
         <tr>
             <th>Applies to:</th>
 
-            <td>Non-replaced <a href="http://www.w3.org/TR/CSS21/visuren.html#block-boxes">block containers</a>. 
+            <td>Non-replaced <a href="http://www.w3.org/TR/CSS21/visuren.html#block-boxes">block containers</a> whose display property computes to block, inline-block or table-cell. 
             <br/>  
             This might be expanded in future versions of the specification
             to allow other types of containers to receive flow content.</td>
@@ -782,27 +782,6 @@ <h3 id="the-flow-from-property">The 'flow-from' property</h3>
         and, consequently, 
         its children are not formatted visually.
     </div>
-    
-    <div class="note"><span class="note-prefix">Note </span>
-      <p>At the time of this note-writing, 
-        the <code>display</code> values that always result
-        in a non-replaced block container include 
-        <code>block</code>, 
-        <code>inline-block</code>, 
-        <code>table-cell</code>, 
-        <code>table-caption</code>, 
-        and <code>list-item</code>. 
-        All of these display values 
-        work as regions with 
-        non-replaced elements.</p>
-      <p>The <code>flex</code> 
-        and <code>grid</code> display values 
-        do not result in block containers 
-        (they are defined as flex containers 
-         and grid elements, respectively). 
-        So 'flow-from' combined with those display values 
-        does not result in a CSS Region.</p>
-    </div>
 
     <p><span title="region">CSS Regions</span> 
       create a new 
@@ -1652,7 +1631,7 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
         the <code>NamedFlow</code> instance 
         at index <em>index</em>
         in the collection 
-        or <code class="idl">undefined</code> 
+        or <code class="idl">null</code> 
         if <em>index</em> is out of range.
         An object <code>collection</code> 
         implementing <code>NamedFlowCollection</code> 
@@ -1664,7 +1643,7 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
         in the collection 
         whose name attribute 
         matches the supplied <em>name</em>, 
-        or <code class="idl">undefined</code> 
+        or <code class="idl">null</code> 
         if there is no match.
 
     <p>The <dfn id="dom-named-flow"><code class="idl">NamedFlow</code></dfn> 
@@ -2469,6 +2448,8 @@ <h2 id="changes">Changes</h2>
     <h3 id="changes_from_May_28_2013">Changes from <a href="http://www.w3.org/TR/2013/WD-css3-regions-20130528/">May 28<sup>th</sup> 2013</a> version</h3>
 
     <ul>
+      <li>Changed NamedFlowCollection getters back to null when there is no NamedFlow.</li>
+      <li>Restricted flow-from to blocks, inline-blocks and table-cells</li>
       <li>Removed issue on user events and added note describing solution(s)</li>
       <li>Changed type of NamedFlow.getContent() from NodeList to sequence&lt;Node&gt;</li>
     </ul>
@@ -2523,8 +2504,9 @@ <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
     <p>In addition, the editors would like to thank the following individuals for their contributions,
         either during the conception of CSS regions or during its development and specification review
         process:</p>
-    <p>Rossen Atanassov, 
+    <p>Erik Arvidsson, 
       Tab Atkins, 
+      Catalin Badea, 
       Mihai Balan, 
       Andrei Bucur, 
       Razvan Caliman, 
@@ -2535,6 +2517,7 @@ <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
       Dimitri Glazkov, 
       Daniel Glazman, 
       Arno Gourdol, 
+      Catalin Grigoroscuta, 
       David Hyatt, 
       Brian Heuston, 
       Ian Hickson, 
@@ -2554,6 +2537,7 @@ <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
       Anton Prowse, 
       Peter Sorotokin, 
       Elliott Sprehn, 
+      Radu Stavila, 
       Christian Stockwell, 
       Eugene Veselov, 
       Boris Zbarsky,