W3C home > Mailing lists > Public > public-css-commits@w3.org > February 2012

csswg/css3-regions Overview.html,1.51,1.52 Overview.src.html,1.56,1.57

From: Vincent Hardy via cvs-syncmail <cvsmail@w3.org>
Date: Sat, 04 Feb 2012 10:52:51 +0000
To: public-css-commits@w3.org
Message-Id: <E1RtdEh-0005XK-B8@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-regions
In directory hutz:/tmp/cvs-serv20182

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Implemented editorial changes from Alex's review http://lists.w3.org/Archives/Public/www-style/2012Feb/0001.html

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-regions/Overview.html,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -d -r1.51 -r1.52
--- Overview.html	4 Feb 2012 07:19:56 -0000	1.51
+++ Overview.html	4 Feb 2012 10:52:49 -0000	1.52
@@ -778,7 +778,8 @@
    element's content across column boxes (see <a href="#CSS3COL"
    rel=biblioentry>[CSS3COL]<!--{{CSS3COL}}--></a>). One difference is that
    page boxes are generated based on the available content whereas regions
-   are a predefined set of recipient boxes for the named flow content.
+   are a set of recipient boxes for the named flow content whose dynamic
+   generation is not in the scope of this specification.
 
   <p><span title=region>Regions</span> are organized in to a <span
    title=region-chain>region chain</span>.
@@ -956,10 +957,18 @@
    <p>will move all tables in the &lsquo;<code
     class=property>table-content</code>&rsquo; named flow. However, the</p>
 
+   <pre>table &gt; * {flow-into: table-content} ...</pre>
+
+   <p>selector will move all immediate children of all table elements into
+    the ‘table-content’ named flow (which may be useful as it will
+    usually result, if the immediate children are rows, in merging rows of
+    multiple tables), but the</p>
+
    <pre>table * {flow-into: table-content}</pre>
 
-   <p>selector will move all the descendants of table elements in the
-    &lsquo;<code class=property>table-content</code>&rsquo; named flow. This
+   <p>selector will move all descendants of table elements into the
+    ‘table-content’ named flow, transforming the element tree into a flat
+    list in order of opening tags (which is probably not intentional). This
     will make all the descendants of table elements siblings in the named
     flow. Having the descendants become siblings in the named flow results in
     a different processing (see the <a
@@ -1149,39 +1158,6 @@
    potentially impact the content laid out in regions, just as for
    non-regions.
 
-  <div class=example>
-   <p>In the following example, the inline content coming from the <code
-    class=html>body_text</code> <a href="#named-flow0">named flow</a> wraps
-    around the <code class=html>#float</code> box.</p>
-
-   <pre>
-    &lt;style&gt;
-    #float {
-        float: left;
-        width: 100px;
-        height: 300px;
-    }
-
-    #region1, #region2 {
-        width: 200px;
-        height: 200px;
-        flow-from: body_text;
-    }
-
-    #content {
-        flow-into: body_text;
-    }
-    &lt;/style&gt;
-
-    &lt;div id="float"&gt;&lt;/div&gt;
-
-    &lt;div id="region1"&gt;&lt;/div&gt;
-    &lt;div id="region2"&gt;&lt;/div&gt;
-
-    &lt;div id="content"&gt;&lt;/div&gt; 
-    </pre>
-  </div>
-
   <h4 id=auto-width-on-regions><span class=secno>4.2.1. </span>Auto width on
    regions</h4>
 
@@ -1218,8 +1194,7 @@
 
   <p>Each break ends layout in the current region and causes remaining pieces
    of content from the named flow to be visually formatted in the following
-   region in the region chain. Note that there is no region break in the last
-   region associated with a named flow.
+   region in the region chain, if there is one.
 
   <p>The following extends the &lsquo;<a href="#break-before"><code
    class=property>break-before</code></a>&rsquo;, &lsquo;<a
@@ -1385,6 +1360,13 @@
   <h3 id=the-region-overflow-property><span class=secno>4.4. </span>The
    region-overflow property</h3>
 
+  <div class=issue-marker data-bug_id=15878 data-bug_status=NEW> <a
+   href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15878">Bug-15878</a>
+   <div class=issue-details>
+    <p class=short-desc>region-overflow:nobreak</p>
+   </div>
+  </div>
+
   <table class=propdef summary="break-after property definition">
    <tbody>
     <tr>
@@ -1928,8 +1910,8 @@
     </pre>
 
   <p>The <dfn id=dom-namedflow-collection-length><code
-   class=idl>length</code></dfn> attribute value is the number of items in
-   the collection.
+   class=idl>length</code></dfn> attribute returns the number of items in the
+   collection.
 
   <p>The <dfn id=dom-namedflow-collection-item><code
    class=idl>item(index)</code></dfn> method returns the item at index
@@ -1940,6 +1922,14 @@
    interface offers a representation of the <a href="#named-flow0">named
    flow</a>.
 
+  <div class=issue-marker data-bug_id=15879 data-bug_status=NEW> <a
+   href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15879">Bug-15879</a>
+   <div class=issue-details>
+    <p class=short-desc>getRegionsByContentNode and contentNodes: change
+     naming?</p>
+   </div>
+  </div>
+
   <pre class=idl>
 interface <a href="#dom-namedflow">NamedFlow</a> {
   readonly attribute <a
@@ -1951,20 +1941,19 @@
   <a
    href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-536297177">NodeList</a> getRegionsByContentNode(<a
    href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1950641247">Node</a> node);
-  };
 };</pre>
 
   <p>The <dfn id=dom-namedflow-name><code class=idl>name</code></dfn>
-   attribute value is the name of the <a href="#dom-namedflow"><code
+   attribute returns the name of the <a href="#dom-namedflow"><code
    class=idl>NamedFlow</code></a> instance.
 
   <p>The <dfn id=dom-namedflow-overflow><code class=idl>overflow</code></dfn>
-   attribute value is true if the named flow does not fully fit in the
-   associated regions. Otherwise, it is false. A <a
+   attribute returns true if the named flow does not fully fit in the
+   associated regions. Otherwise, it returns false. A <a
    href="#dom-namedflow"><code class=idl>NamedFlow</code></a> object is live.
 
   <p>The <dfn id=dom-namedflow-contentnodes>contentNodes</dfn> attribute
-   value is an ordered collection of nodes that constitute the named flow.
+   returns an ordered collection of nodes that constitute the named flow.
    Note that this collection is live: every time it is queried it must return
    the same object, and the object is always up to date.
 
@@ -2006,22 +1995,19 @@
 </pre>
 
   <p>The <dfn id=dom-element-regionoverflow><code
-   class=idl>regionOverflow</code></dfn> attribute can take one of the
+   class=idl>regionOverflow</code></dfn> attribute returns one of the
    following values:
 
   <dl>
    <dt>&lsquo;<a href="#dom-namedflow-overflow"><code
     class=property>overflow</code></a>&rsquo;
 
-   <dd>the region element's content overflows the region's <a
-    href="http://www.w3.org/TR/CSS21/box.html#box-dimensions">content
-    box</a>. Note that the region's <a
+   <dd>the region is the last one in the <span title=region-chain>region
+    chain</span> and not able to fit the remaining content from the <a
+    href="#named-flow0">named flow</a>. Note that the region's <a
     href="http://www.w3.org/TR/CSS21/visufx.html#overflow"><code
     class=idl>overflow</code></a> property value can be used to control the
-    visibility of the overflowing content. This means that the region is the
-    last one in the <span title=region-chain>region chain</span> and not able
-    to fit the remaining content from the <a href="#named-flow0">named
-    flow</a>.
+    visibility of the overflowing content.
 
    <dt>&lsquo;<code class=property>fit</code>&rsquo;
 
@@ -2047,6 +2033,17 @@
    <dd>The element is not a <span>region</span>.
   </dl>
 
+  <p>Note that if there is no content in the named flow, all regions
+   associated with that named flow should have their &lsquo;<a
+   href="#dom-namedflow-overflow"><code
+   class=property>overflow</code></a>&rsquo; attribute return &lsquo;<code
+   class=property>empty</code>&rsquo;. If there is content in the flow but
+   that content does not generate any box for visual formatting, the
+   &lsquo;<a href="#dom-namedflow-overflow"><code
+   class=property>overflow</code></a>&rsquo; attribute on the first region in
+   the region chain associated with the flow will return &lsquo;<code
+   class=property>fit</code>&rsquo;.
+
   <p>The <dfn id=dom-element-getregionflowranges>getRegionFlowRanges</dfn>
    method returns an array of <a
    href="http://www.w3.org/TR/DOM-Level-2-Traversal-Range/ranges.html#Level-2-Range-idl">
@@ -2227,6 +2224,10 @@
 
    <li>Modified initial examples as per <a
     href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15131">Bug 15131</a>
+
+   <li>Multiple editorial changes following <a
+    href="http://lists.w3.org/Archives/Public/www-style/2012Feb/0001.html">mailing
+    list review comments</a>
   </ul>
 
   <h3 id="changes_from_June_09_2011"><span class=secno>10.2. </span>Changes

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-regions/Overview.src.html,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -d -r1.56 -r1.57
--- Overview.src.html	4 Feb 2012 07:19:56 -0000	1.56
+++ Overview.src.html	4 Feb 2012 10:52:49 -0000	1.57
@@ -618,7 +618,8 @@
     document's content across multiple pages (see [[CSS3PAGE]]) or a multi-column element's content
     across column boxes (see [[CSS3COL]]). One difference is that
     page boxes are generated based on the available content whereas regions are
-    a predefined set of recipient boxes for the named flow content.</p>
+    a set of recipient boxes for the named flow content whose dynamic 
+    generation is not in the scope of this specification.</p>
 
     <p><span title=
     "region">Regions</span> are organized in to a <span title=
@@ -781,12 +782,16 @@
         <pre>table {flow-into: table-content}</pre> 
         <p>will
         move all tables in the 'table-content' named flow. However, the</p>
+        <pre>table &gt; * {flow-into: table-content} ...</pre>
+        <p>selector will move all immediate children of all table elements into the 
+        ‘table-content’ named flow (which may be useful as it will usually result, if
+        the immediate children are rows, in merging rows of multiple tables), but the</p>
         <pre>table * {flow-into: table-content}</pre>
-        <p>selector will move all
-        the descendants of table elements in the 'table-content' named flow. This will make all
-        the descendants of table elements siblings in the named flow. Having the descendants become siblings
-        in the named flow results 
-        in a different processing (see the <a href="http://www.w3.org/TR/2011/REC-CSS2-20110607/tables.html#anonymous-boxes">CSS 2.1's anonymous table objects</a>). This note illustrates how authors must exercise caution when choosing a particular
+        <p>selector will move all descendants of table elements into the ‘table-content’ 
+        named flow, transforming the element tree into a flat list in order of 
+        opening tags (which is probably not intentional). This will make all
+        the descendants of table elements siblings in the named flow. Having the descendants 
+        become siblings in the named flow results in a different processing (see the <a href="http://www.w3.org/TR/2011/REC-CSS2-20110607/tables.html#anonymous-boxes">CSS 2.1's anonymous table objects</a>). This note illustrates how authors must exercise caution when choosing a particular
         selector for setting the 'flow-into' property to avoid unintended results.</p> 
     </div>
 
@@ -956,40 +961,7 @@
     <p>
         Floats or other exclusions (see [[CSS3-EXCLUSIONS]]) potentially impact the
     content laid out in regions, just as for non-regions.</p>
-    
-
-        <div class="example">
-            <p>In the following example, the inline content coming from the
-            <code class="html">body_text</code> <span>named
-            flow</span> wraps around the <code class="html">#float</code> box.</p>
-            <pre>
-    &lt;style&gt;
-    #float {
-        float: left;
-        width: 100px;
-        height: 300px;
-    }
-
-    #region1, #region2 {
-        width: 200px;
-        height: 200px;
-        flow-from: body_text;
-    }
-
-    #content {
-        flow-into: body_text;
-    }
-    &lt;/style&gt;
-
-    &lt;div id="float"&gt;&lt;/div&gt;
-
-    &lt;div id="region1"&gt;&lt;/div&gt;
-    &lt;div id="region2"&gt;&lt;/div&gt;
 
-    &lt;div id="content"&gt;&lt;/div&gt; 
-    </pre>
-        </div>
-        
     
     <h4>Auto width on regions</h4>
     
@@ -1021,9 +993,7 @@
 
     <p>Each break ends layout in the current region and causes remaining pieces
     of content from the named flow to be visually formatted in the following
-    region in the region chain. Note
-    that there is no region break in the last region associated with a named
-    flow.</p>
+    region in the region chain, if there is one.</p>
 
     <p>The following extends the 'break-before', 'break-after' and
     'break-inside' properties from the [[!CSS3COL]] specification to account
@@ -1202,6 +1172,13 @@
 
     <h3 id="the-region-overflow-property">The region-overflow property</h3>
 
+    <div class="issue-marker" data-bug_id="15878" data-bug_status="NEW">
+        <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15878">Bug-15878</a>
+        <div class="issue-details">
+            <p class="short-desc">region-overflow:nobreak</p>
+        </div>  
+    </div>
+    
     <table class="propdef" summary="break-after property definition">
         <tr>
             <td><em>Name:</em></td>
@@ -1696,31 +1673,38 @@
     </pre>
     
     <p>The <dfn id="dom-namedflow-collection-length"><code class="idl">length</code></dfn> 
-        attribute value is the number of items in the collection.</p>
+        attribute returns the number of items in the collection.</p>
     <p>The <dfn id="dom-namedflow-collection-item"><code class="idl">item(index)</code></dfn> 
         method returns the item at index <em>index</em>
         in the collection or <code class="idl">null</code> if <em>index</em> is out of range.</p> 
 
     <p>The <dfn id="dom-namedflow"><code class="idl">NamedFlow</code></dfn>
     interface offers a representation of the <span>named flow</span>.</p>
+    
+    <div class="issue-marker" data-bug_id="15879" data-bug_status="NEW">
+        <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15879">Bug-15879</a>
+        <div class="issue-details">
+            <p class="short-desc">getRegionsByContentNode and contentNodes: change naming?</p>
+        </div>  
+    </div>
+    
     <pre class="idl">
 interface <a href="#dom-namedflow">NamedFlow</a> {
   readonly attribute <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name;
   readonly attribute boolean <a href="#dom-namedflow-overflow">overflow</a>;
   readonly attribute <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-536297177">NodeList</a> contentNodes;
   <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-536297177">NodeList</a> getRegionsByContentNode(<a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-1950641247">Node</a> node);
-  };
 };</pre>
 
     <p>The <dfn id="dom-namedflow-name"><code class="idl">name</code></dfn> attribute
-        value is the name of the <code class="idl">NamedFlow</code> instance.</p>
+     returns the name of the <code class="idl">NamedFlow</code> instance.</p>
 
     <p>The <dfn id="dom-namedflow-overflow"><code class=
-    "idl">overflow</code></dfn> attribute value is true if the named flow does not
-    fully fit in the associated regions. Otherwise, it is false. A 
+    "idl">overflow</code></dfn> attribute returns true if the named flow does not
+    fully fit in the associated regions. Otherwise, it returns false. A 
     <code class="idl">NamedFlow</code> object is live.</p>
     
-    <p>The <dfn id="dom-namedflow-contentnodes">contentNodes</dfn> attribute value is 
+    <p>The <dfn id="dom-namedflow-contentnodes">contentNodes</dfn> attribute returns 
         an ordered collection of nodes that constitute the named flow. Note that this 
         collection is live: every time it is 
         queried it must return the same object, and the object is always up to date.
@@ -1759,21 +1743,19 @@
 </pre>
 
     <p>The <dfn id="dom-element-regionoverflow"><code class=
-    "idl">regionOverflow</code></dfn> attribute can take one of the following
+    "idl">regionOverflow</code></dfn> attribute returns one of the following
     values:</p>
 
     <dl>
         <dt>'overflow'</dt>
 
-        <dd>the region element's content overflows the region's <a href=
-        "http://www.w3.org/TR/CSS21/box.html#box-dimensions">content box</a>.
+        <dd>the region is the last one in the 
+        <span title="region-chain">region chain</span> and
+        not able to fit the remaining content from the <span>named flow</span>.
         Note that the region's <a href=
         "http://www.w3.org/TR/CSS21/visufx.html#overflow"><code class=
         "idl">overflow</code></a> property value can be used to control the
-        visibility of the overflowing content. This means that the region is
-        the last one in the <span title="region-chain">region chain</span> and
-        not able to fit the remaining content from the <span
-        >named flow</span>.</dd>
+        visibility of the overflowing content. </dd>
 
         <dt>'fit'</dt>
 
@@ -1797,6 +1779,12 @@
         <dt>'undefined'</dt>
         <dd>The element is not a <span>region</span>.</dd>
     </dl>
+    
+    <p>Note that if there is no content in the named flow, all regions associated
+        with that named flow should have their 'overflow' attribute return 'empty'.
+        If there is content in the flow but that content does not generate any box
+        for visual formatting, the 'overflow' attribute on the first region in the 
+        region chain associated with the flow will return 'fit'.</p>
 
     <p>The <dfn id="dom-element-getregionflowranges">getRegionFlowRanges</dfn> method returns
     an array of <a href=
@@ -1905,6 +1893,9 @@
         <li>Modified wording about containing block resolution for absolutely positioned elements in a 
             named flow.</li>
         <li>Modified initial examples as per <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15131">Bug 15131</a></li>
+        <li>Multiple editorial changes following 
+            <a href="http://lists.w3.org/Archives/Public/www-style/2012Feb/0001.html">mailing list review comments</a></li>
+        
     </ul>
     
 
@@ -2074,7 +2065,8 @@
     </div>  
 </div>
     </script>   
-    <!--
+    
+<!--
     <script type="text/javascript" src="BugzillaTracker.js"></script>
     <script type="text/javascript" src="BugzillaTrackerCSSRegions.js"></script>
     -->
Received on Saturday, 4 February 2012 10:52:58 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:44:50 UTC