- From: Vincent Hardy via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 13 Jul 2011 20:41:50 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-regions In directory hutz:/tmp/cvs-serv11304 Modified Files: Overview.html Overview.src.html Log Message: Updated following discussion with Alex Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css3-regions/Overview.html,v retrieving revision 1.12 retrieving revision 1.13 diff -u -d -r1.12 -r1.13 --- Overview.html 13 Jul 2011 17:25:06 -0000 1.12 +++ Overview.html 13 Jul 2011 20:41:48 -0000 1.13 @@ -542,6 +542,11 @@ <p>A <span title=region>region</span>‘<code class=css>s intrinsic width is zero.</code> + <div class=issue> There was a recent discussion on intrinsic sizing of + regions which <a + href="http://lists.w3.org/Archives/Public/www-style/2011Jun/0629.html">has + not been resolved</a>.</div> + <h3 id=flow-breaking-rules><span class=secno>2.3. </span>Flow breaking rules</h3> @@ -920,7 +925,8 @@ <dd>The element is placed (appended) to the flow with that name. The element is said to have a <dfn id=specified-flow>specified flow</dfn>. The values ‘<code class=property>none</code>’, ‘<code - class=property>inherit</code>’ and ‘<code + class=property>inherit</code>’, ‘<code + class=property>default</code>’ and ‘<code class=property>initial</code>’ and invalid flow names. </dl> @@ -1171,6 +1177,18 @@ </div> <div class=issue> + <p><strong>content: from-flow(<low-name>) v.s. from-flow: + <flow-name></strong></p> + + <p><a + href="http://lists.w3.org/Archives/Public/www-style/2011Jun/0413.html">WG + Conference Call, CSSWG Minutes and Resolutions 2011-06-15</a>.</p> + + <p>See <a + href="http://wiki.csswg.org/spec/css3-regions#contentfrom-flow-flow-name-vs-from-flowflow-name">issue</a></p> + </div> + + <div class=issue> <p>Should we consider adding the ability to do the following:</p> <ul> @@ -1591,7 +1609,8 @@ <dd>Content flows as it would in a regular content element. If the content exceeds the container box, it is subject to the <a href="http://www.w3.org/TR/CSS21/visufx.html#propdef-overflow">overflow</a> - property's computed value on the region element. + property's computed value on the region element. Region breaks must be + ignored on the last region. <dt>break @@ -1599,7 +1618,8 @@ property has no effect. If the content does not fit within the <em>region element</em>, the content breaks as if flow was going to continue in a subsequent region. See the <a href="#breaking-rules">breaking rules</a> - section. + section. A forced region break takes precedence over a natural break + point. </dl> <p>The following code sample illustrates the usage of the ‘<a @@ -1893,7 +1913,7 @@ <pre class=idl> [Supplemental] interface <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document">Document</a> { - <a href="#dom-namedflow">NamedFlow</a> <a href="#dom-document-flowwithname">flowWithName(</a><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name); + <a href="#dom-namedflow">NamedFlow</a> <a href="#dom-document-getflowbyname">getFlowByName(</a><a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name); }; </pre> @@ -1909,7 +1929,8 @@ <p>The <dfn id=dom-namedflow-overflow><code class=idl>overflow</code></dfn> property is true if the named flow does not fully fit in the associated - regions. Otherwise, it is false. + regions. Otherwise, it is false. A <a href="#dom-namedflow"><code + class=idl>NamedFlow</code></a> object is live. <p>With the <a href="#dom-namedflow"><code class=idl>NamedFlow</code></a> interface, authors can easily check if all content has been fitted into @@ -1928,7 +1949,7 @@ <pre class=idl> [Supplemental] interface <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-745549614">Element</a> { readonly attribute <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> <a href="#dom-element-regionoverflow">regionOverflow</a>; - readonly <a href="#">Range</a>[] <a href="#dom-element-flowranges">flowRanges</a>; + getter <a href="#">Range</a>[] <a href="#dom-element-getregionflowranges">getRegionFlowRanges</a>; }; </pre> @@ -1938,7 +1959,8 @@ following values: <dl> - <dt>overflow + <dt>‘<a href="#dom-namedflow-overflow"><code + class=property>overflow</code></a>’ <dd>the region element's content overflows the region's <a href="http://www.w3.org/TR/CSS21/box.html#box-dimensions">content @@ -1950,7 +1972,7 @@ to fit the remaining content from the <span title=named-flow>named flow</span>. - <dt>fit + <dt>‘<code class=property>fit</code>’ <dd>the region element's content fits into the region's <a href="http://www.w3.org/TR/CSS21/box.html#box-dimensions">content @@ -1963,31 +1985,34 @@ title=named-flow>named flow</span> (for example if the region is too span to accommodate any content). - <dt>empty + <dt>‘<code class=property>empty</code>’ <dd>the region element has no content and is empty. All content from the <span title=named-flow>named flow</span> was fitted in regions with a lower ‘<a href="#content-order"><code class=property>content-order</code></a>’ value. - </dl> - <p>If an element is not a <span>region</span>, then the <code - class=idl>contentOverflow</code> attribute value is ‘<code - class=property>fit</code>’. + <dt>‘<code class=property>undefined</code>’ + + <dd>The element is not a <span>region</span>. + </dl> <p> - <p>The <dfn id=dom-element-flowranges>flowRanges</dfn> attribute is an - array of <a + <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"> Range</a> instances corresponding to the content from the region flow that is positioned in the region. - <p>If an element is not an <span>region</span>, then the <a - href="#dom-element-flowranges"><code class=idl><span - title="#document-element-flowranges">flowRanges</span></code></a> - attribute returns an array with a single <code class=idl><span - title=range>Range</span></code> matching the element's full content. + <p>If an element is not a <span>region</span>, the <a + href="#dom-element-getregionflowranges"><code class=idl><span + title="#document-element-getregionflowranges">getRegionFlowRanges</span></code></a> + method throws a <a + href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-17189187"><code + class=idl>DOMException</code></a> with the <a + href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMException-INVALID_ACCESS_ERR"><code + class=idl>INVALID_ACCESS_ERR</code></a> error code. <div class=note> The Element interface extension is only available to regions that are document elements and not to regions that are @@ -2009,7 +2034,7 @@ <p>Region <a href="http://www.w3.org/TR/DOM-Level-3-Events/#glossary-event">Event - Targets</a> dispatch <code class=idl>NamedFlowEvent</code>s when there is + Targets</a> dispatch <code class=idl>NamedFlowUpdate</code>s when there is a possible layout change of their named flow segment. <table border=0 cellpadding=2 cellspacing=0 class=event-desc summary="This @@ -2018,7 +2043,7 @@ <tr class="assert must"> <th>Type - <td class=eventname><strong><code>NamedFlowEvent</code></strong> + <td class=eventname><strong><code>NamedFlowUpdate</code></strong> <tr class="assert must"> <th>Interface @@ -2279,7 +2304,7 @@ into a note explaining that the NamedFlow interface can be used when regions are pseudo-elements. - <li>Added NamedFlowEvent + <li>Added NamedFlowUpdate </ul> <li>Excluded ‘<code class=property>none</code>’, ‘<code @@ -2296,6 +2321,30 @@ <li>Added specification of how the ‘<a href="#flow2"><code class=property>flow</code></a>’ property interacts with object, embed and iframe elements. + + <li>Excluded ‘<code class=property>default</code>’ from the + possible identifier names on the flow property because it <a + href="http://www.w3.org/TR/2006/WD-css3-values-20060919/#keywords">may + get reserved</a>. + + <li>Added to the definition of ‘<code + class=property>auto</code>’ on ‘<a + href="#region-overflow"><code + class=property>region-overflow</code></a>’ specifying that region + breaks must be ignored. + + <li>Renamed ‘<code class=css>Document.flowWithName</code>’ to + ‘<code class=css>Document.getFlowByName</code>’ since it is + not a property. + + <li>Added a note that a ‘<a href="#dom-namedflow"><code + class=property>NamedFlow</code></a>’ instance is live. + + <li>Added an ‘<code class=property>undefined</code>’ string + value to the regionOverflow property on the Element interface extension. + + <li>Renamed NamedFlowEvent to NamedFlowUpdate to avoid having ‘<code + class=property>Event</code>’ in the event name. </ul> <h2 class=no-num id=acknowledgments>Acknowledgments</h2> @@ -2465,15 +2514,15 @@ <li>flow, <a href="#flow2" title=flow><strong>3.1.</strong></a> - <li>flowRanges, <a href="#dom-element-flowranges" - title=flowRanges><strong>4.2.</strong></a> - <li>from-flow(<ident>), <a href="#from-flow-name" title="from-flow(<ident>)"><strong>3.2.</strong></a> <li>generated flow, <a href="#generated-flow-def" title="generated flow"><strong>2.4.4.</strong></a> + <li>getRegionFlowRanges, <a href="#dom-element-getregionflowranges" + title=getRegionFlowRanges><strong>4.2.</strong></a> + <li>grid cell flow, <a href="#grid-cell-flow" title="grid cell flow"><strong>2.4.3.</strong></a> Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css3-regions/Overview.src.html,v retrieving revision 1.10 retrieving revision 1.11 diff -u -d -r1.10 -r1.11 --- Overview.src.html 13 Jul 2011 15:57:41 -0000 1.10 +++ Overview.src.html 13 Jul 2011 20:41:48 -0000 1.11 @@ -356,6 +356,11 @@ property).</p> <p>A <span title="region">region</span>'s intrinsic width is zero.</p> + + <div class="issue"> + There was a recent discussion on intrinsic sizing of regions which + <a href="http://lists.w3.org/Archives/Public/www-style/2011Jun/0629.html">has not been resolved</a>. + </div> <h3 id="flow-breaking-rules">Flow breaking rules</h3> @@ -689,7 +694,7 @@ <dd>The element is placed (appended) to the flow with that name. The element is said to have a <dfn id="specified-flow">specified - flow</dfn>. The values 'none', 'inherit' and 'initial' and invalid flow + flow</dfn>. The values 'none', 'inherit', 'default' and 'initial' and invalid flow names.</dd> </dl> @@ -925,6 +930,13 @@ </div> <div class="issue"> + <p><strong>content: from-flow(<low-name>) v.s. from-flow: <flow-name></strong></p> + + <p><a href="http://lists.w3.org/Archives/Public/www-style/2011Jun/0413.html">WG Conference Call, CSSWG Minutes and Resolutions 2011-06-15</a>.</p> + + <p>See <a href="http://wiki.csswg.org/spec/css3-regions#contentfrom-flow-flow-name-vs-from-flowflow-name">issue</a></p> + </div> + <div class="issue"> <p>Should we consider adding the ability to do the following:</p> <ul> @@ -1362,7 +1374,8 @@ <dd>Content flows as it would in a regular content element. If the content exceeds the container box, it is subject to the <a href= "http://www.w3.org/TR/CSS21/visufx.html#propdef-overflow">overflow</a> - property's computed value on the region element.</dd> + property's computed value on the region element. Region breaks must be + ignored on the last region.</dd> <dt>break</dt> @@ -1370,7 +1383,8 @@ property has no effect. If the content does not fit within the <em>region element</em>, the content breaks as if flow was going to continue in a subsequent region. See the <a href= - "#breaking-rules">breaking rules</a> section.</dd> + "#breaking-rules">breaking rules</a> section. A forced region break takes precedence over + a natural break point.</dd> </dl> <p>The following code sample illustrates the usage of the 'region-overflow' @@ -1641,7 +1655,7 @@ [Supplemental] interface <a href= "http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document">Document</a> { <a href="#dom-namedflow">NamedFlow</a> <a href= -"#dom-document-flowwithname">flowWithName(</a><a href= +"#dom-document-getflowbyname">getFlowByName(</a><a href= "http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name); }; </pre> @@ -1657,7 +1671,8 @@ <p>The <dfn id="dom-namedflow-overflow"><code class= "idl">overflow</code></dfn> property is true if the named flow does not - fully fit in the associated regions. Otherwise, it is false.</p> + fully fit in the associated regions. Otherwise, it is false. A + <code class="idl">NamedFlow</code> object is live.</p> <p>With the <a href="#dom-namedflow"><code class="idl">NamedFlow</code></a> interface, authors can easily check if all content has been fitted into @@ -1677,8 +1692,8 @@ "http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-745549614">Element</a> { readonly attribute <a href= "http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> <a href="#dom-element-regionoverflow">regionOverflow</a>; - readonly <a href="#">Range</a>[] <a href= -"#dom-element-flowranges">flowRanges</a>; + getter <a href="#">Range</a>[] <a href= +"#dom-element-getregionflowranges">getRegionFlowRanges</a>; }; </pre> @@ -1688,7 +1703,7 @@ values:</p> <dl> - <dt>overflow</dt> + <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>. @@ -1700,7 +1715,7 @@ not able to fit the remaining content from the <span title= "named-flow">named flow</span>.</dd> - <dt>fit</dt> + <dt>'fit'</dt> <dd>the region element's content fits into the region's <a href= "http://www.w3.org/TR/CSS21/box.html#box-dimensions">content box</a>. @@ -1713,28 +1728,30 @@ <span title="named-flow">named flow</span> (for example if the region is too span to accommodate any content).</dd> - <dt>empty</dt> + <dt>'empty'</dt> <dd>the region element has no content and is empty. All content from the <span title="named-flow">named flow</span> was fitted in regions with a lower 'content-order' value.</dd> + + <dt>'undefined'</dt> + <dd>The element is not a <span>region</span>.</dd> </dl> - <p>If an element is not a <span>region</span>, then the <code class= - "idl">contentOverflow</code> attribute value is 'fit'.</p> + <p> </p> - <p>The <dfn id="dom-element-flowranges">flowRanges</dfn> attribute is an - array of <a href= + <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"> Range</a> instances corresponding to the content from the region flow that is positioned in the region.</p> - <p>If an element is not an <span>region</span>, then the <code class= - "idl"><span title="#document-element-flowranges">flowRanges</span></code> - attribute returns an array with a single <code class="idl"><span title= - "range">Range</span></code> matching the element's full content.</p> + <p>If an element is not a <span>region</span>, the <code class= + "idl"><span title="#document-element-getregionflowranges">getRegionFlowRanges</span></code> + method throws a <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#ID-17189187"><code class="idl">DOMException</code></a> with the + <a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMException-INVALID_ACCESS_ERR"><code class="idl">INVALID_ACCESS_ERR</code></a> error code.</p> <div class="note"> The Element interface extension is only available to regions that are @@ -1756,12 +1773,12 @@ <h3 id="region-flow-layout-events">Region Flow Layout Events</h3> <p>Region <a href="http://www.w3.org/TR/DOM-Level-3-Events/#glossary-event">Event Targets</a> - dispatch <code class="idl">NamedFlowEvent</code>s when there is a possible layout change of their named flow + dispatch <code class="idl">NamedFlowUpdate</code>s when there is a possible layout change of their named flow segment.</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>NamedFlowEvent</code></strong></td></tr> + <td class="eventname"><strong><code>NamedFlowUpdate</code></strong></td></tr> <tr class="assert must"><th>Interface</th> <td><a href="#events-UIEvent"><code>UIEvent</code></a></td></tr> <tr class="assert must"><th>Sync / Async</th> <td>Sync</td></tr> <tr class="assert must"><th>Bubbles</th> <td>Yes</td></tr> @@ -1975,7 +1992,7 @@ <ul> <li>Turned the first issue in the "Extensions to the Element interface" into a note explaining that the NamedFlow interface can be used when regions are pseudo-elements.</li> - <li>Added NamedFlowEvent</li> + <li>Added NamedFlowUpdate</li> </ul> </li> <li>Excluded 'none', 'inherit' and 'initial' from the possible identifier names on @@ -1984,6 +2001,15 @@ column boxes are not addressable by selectors, they cannot be regions.</li> <li>Added specification of how the 'flow' property interacts with object, embed and iframe elements.</li> + <li>Excluded 'default' from the possible identifier names on the flow property because it + <a href="http://www.w3.org/TR/2006/WD-css3-values-20060919/#keywords">may get reserved</a>.</li> + <li>Added to the definition of 'auto' on 'region-overflow' specifying that region breaks must + be ignored.</li> + <li>Renamed 'Document.flowWithName' to 'Document.getFlowByName' since it is not a property.</li> + <li>Added a note that a 'NamedFlow' instance is live.</li> + <li>Added an 'undefined' string value to the regionOverflow property on the Element interface + extension.</li> + <li>Renamed NamedFlowEvent to NamedFlowUpdate to avoid having 'Event' in the event name.</li> </ul> <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
Received on Wednesday, 13 July 2011 20:41:58 UTC