- From: Vincent Hardy via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 26 Oct 2011 01:27:42 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-regions In directory hutz:/tmp/cvs-serv29076 Modified Files: Overview.html Overview.src.html alternate-spec-style.css Log Message: Added Alex's ACTION-350 Index: Overview.html =================================================================== RCS file: /sources/public/csswg/css3-regions/Overview.html,v retrieving revision 1.22 retrieving revision 1.23 diff -u -d -r1.22 -r1.23 --- Overview.html 24 Oct 2011 23:48:45 -0000 1.22 +++ Overview.html 26 Oct 2011 01:27:40 -0000 1.23 @@ -27,6 +27,23 @@ opacity: 1; color: #46A4E9; } + + div.issue-marker { + position: absolute; + width: 20ex; + margin-left: -26ex; + padding-left: 1em; + padding: 5px; + font-weight: normal; + font-size: 11px; + text-align: right; + background-color: white; + font-size: 90%; + } + + div.issue-marker a { + color: red; + } </style> <body> @@ -36,14 +53,14 @@ <h1 id=css-regions-module>CSS Regions Module</h1> - <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 24 October + <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 26 October 2011</h2> <dl> <dt>This version: <dd><a - href="http://www.w3.org/TR/2011/ED-css3-regions-20111024/">http://www.w3.org/csswg/css3-regions</a> + href="http://www.w3.org/TR/2011/ED-css3-regions-20111026/">http://www.w3.org/csswg/css3-regions</a> <dt>Latest version: @@ -636,7 +653,7 @@ <object>, <embed></h4> <div class=issue-marker><a - href="http://wiki.csswg.org/spec/css3-regions?&#issue-19special-behavior-of-iframe-flow">I-19</a></div> + href="http://wiki.csswg.org/spec/css3-regions?&#issue-19special-behavior-of-iframe-flow">Issue-19</a></div> <p>Optionally, implementations can support the ‘<a href="#flow-into"><code class=property>flow-into</code></a>’ @@ -686,14 +703,14 @@ property</h3> <div class=issue-marker><a - href="http://wiki.csswg.org/spec/css3-regions?&#issue-18interplay-of-flow-from-and-content">I-18</a></div> + href="http://wiki.csswg.org/spec/css3-regions?&#issue-18interplay-of-flow-from-and-content">Issue-18</a></div> <p>The ‘<a href="#flow-from"><code class=property>flow-from</code></a>’ property makes an element a region and associates it with a named flow. <div class=issue-marker><a - href="http://wiki.csswg.org/spec/css3-regions?&#issue-12should-we-allow-multi-column-elements-to-be-regions">I-12</a></div> + href="http://wiki.csswg.org/spec/css3-regions?&#issue-12should-we-allow-multi-column-elements-to-be-regions">Issue-12</a></div> <table class=propdef summary="flow-from property definition"> <tbody> @@ -1311,7 +1328,7 @@ rule</h3> <div class=issue-marker><a - href="http://wiki.csswg.org/spec/css3-regions?&#issue-14region-lines-pseudo-selector">I-14</a></div> + href="http://wiki.csswg.org/spec/css3-regions?&#issue-14region-lines-pseudo-selector">Issue-14</a></div> <p>An ‘<code class=css>@region</code>’ rule contains style declarations specific to particular regions. @@ -1341,7 +1358,7 @@ <p>Only a limited list of properties can be set in a region style rule: <div class=issue-marker><a - href="http://wiki.csswg.org/spec/css3-regions?&#issue-20list-of-region-style-properties">I-20</a></div> + href="http://wiki.csswg.org/spec/css3-regions?&#issue-20list-of-region-style-properties">Issue-20</a></div> <ol> <li><a href="http://www.w3.org/TR/CSS2/fonts.html">font properties</a> @@ -1621,16 +1638,32 @@ <pre class=idl> interface <a href="#dom-namedflow">NamedFlow</a> { readonly attribute boolean <a - href=dom-namedflow-overflow>overflow</a>; -}; - -</pre> + 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-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. A <a href="#dom-namedflow"><code class=idl>NamedFlow</code></a> object is live. + <p>The <dfn id=dom-namedflow-contentnodes>contentNodes</dfn> property + 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. + + <p>The <dfn + id=dom-namedflow-getregionsbycontentnodes>getRegionsByContentNode()</dfn> + method gets a collection of regions that contain at least part of the + target content node. This can be used to navigate by bookmark in paginated + view: the method returns regions containing the bookmarked element, which + are then passed to pagination UI to show desired region or page. + <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 existing regions. If it has, the overflow property would be false. @@ -1742,7 +1775,7 @@ there is a possible layout change of their named flow segment. <div class=issue-marker><a - href="http://wiki.csswg.org/spec/css3-regions?&#issue-10should-the-regionlayoutupdate-event-by-sync-or-async">I-10</a></div> + href="http://wiki.csswg.org/spec/css3-regions?&#issue-10should-the-regionlayoutupdate-event-by-sync-or-async">Issue-10</a></div> <table border=0 cellpadding=2 cellspacing=0 class=event-desc summary="This table contains information about the semantics of the given event type"> @@ -2060,6 +2093,9 @@ <li>Added note about nested region styling following <a href="http://lists.w3.org/Archives/Public/www-style/2011Oct/0650.html">a mailing list discussion</a>. + + <li>Added additional DOM interface following <a + href="http://www.w3.org/Style/CSS/Tracker/actions/350">Action 350</a>. </ul> <h2 class=no-num id=acknowledgments>Acknowledgments</h2> @@ -2202,6 +2238,9 @@ <li>break-inside, <a href="#break-inside" title=break-inside><strong>4.3.</strong></a> + <li>contentNodes, <a href="#dom-namedflow-contentnodes" + title=contentNodes><strong>6.1.</strong></a> + <li>current-region, <a href="#current-region" title=current-region><strong>2.3.</strong></a> @@ -2214,6 +2253,10 @@ <li>getRegionFlowRanges, <a href="#dom-element-getregionflowranges" title=getRegionFlowRanges><strong>6.2.</strong></a> + <li>getRegionsByContentNode(), <a + href="#dom-namedflow-getregionsbycontentnodes" + title="getRegionsByContentNode()"><strong>6.1.</strong></a> + <li><a href="#dom-namedflow"><code class=idl>NamedFlow</code></a>, <a href="#dom-namedflow" title=NamedFlow><strong>6.1.</strong></a> Index: alternate-spec-style.css =================================================================== RCS file: /sources/public/csswg/css3-regions/alternate-spec-style.css,v retrieving revision 1.8 retrieving revision 1.9 diff -u -d -r1.8 -r1.9 --- alternate-spec-style.css 24 Oct 2011 23:48:45 -0000 1.8 +++ alternate-spec-style.css 26 Oct 2011 01:27:40 -0000 1.9 @@ -360,26 +360,6 @@ } -div.issue-marker { - position: absolute; - left: 5px; - z-index: 100; - padding-left: 1em; - border: 1px solid rgba(255, 0, 0, 0.3); - border-left: 1em solid red; - padding: 5px; - font-weight: bold; - font-size: 11px; - -webkit-box-shadow: 1px 1px 6px rgba(255, 0, 0, 0.15); - -moz-box-shadow: 1px 1px 6px rgba(255, 0, 0, 0.15); - box-shadow: 1px 1px 6px rgba(255, 0, 0, 0.15); - background-color: white; - -webkit-transform: rotateZ(-30deg) translateZ(0); - -moz-transform: rotate(-30deg); - transform: rotate(-30deg); -} - - .issue { counter-increment: issue; } \ No newline at end of file Index: Overview.src.html =================================================================== RCS file: /sources/public/csswg/css3-regions/Overview.src.html,v retrieving revision 1.24 retrieving revision 1.25 diff -u -d -r1.24 -r1.25 --- Overview.src.html 24 Oct 2011 23:48:45 -0000 1.24 +++ Overview.src.html 26 Oct 2011 01:27:40 -0000 1.25 @@ -27,6 +27,23 @@ opacity: 1; color: #46A4E9; } + + div.issue-marker { + position: absolute; + width: 20ex; + margin-left: -26ex; + padding-left: 1em; + padding: 5px; + font-weight: normal; + font-size: 11px; + text-align: right; + background-color: white; + font-size: 90%; + } + + div.issue-marker a { + color: red; + } </style> @@ -460,7 +477,7 @@ <h4>'flow-into' and <ifram>, <object>, <embed></h4> - <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-19special-behavior-of-iframe-flow">I-19</a></div> + <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-19special-behavior-of-iframe-flow">Issue-19</a></div> <p>Optionally, implementations can support the 'flow-into' property on the <iframe>, <object> and <embed> elements.</p> @@ -501,10 +518,10 @@ <h3 id="the-flow-from-property">The 'flow-from' property</h3> - <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-18interplay-of-flow-from-and-content">I-18</a></div> + <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-18interplay-of-flow-from-and-content">Issue-18</a></div> <p>The 'flow-from' property makes an element a region and associates it with a named flow.</p> - <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-12should-we-allow-multi-column-elements-to-be-regions">I-12</a></div> + <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-12should-we-allow-multi-column-elements-to-be-regions">Issue-12</a></div> <table class="propdef" summary="flow-from property definition"> <tr> @@ -1125,7 +1142,7 @@ <h3 id="the-at-region-style-rule">The @region rule</h3> - <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-14region-lines-pseudo-selector">I-14</a></div> + <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-14region-lines-pseudo-selector">Issue-14</a></div> <p>An '@region' rule contains style declarations specific to particular regions.</p> @@ -1149,7 +1166,7 @@ selectors found in the style rule.</p> <p>Only a limited list of properties can be set in a region style rule:</p> - <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-20list-of-region-style-properties">I-20</a></div> + <div class="issue-marker"><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-20list-of-region-style-properties">Issue-20</a></div> <ol> <li><a href="http://www.w3.org/TR/CSS2/fonts.html">font properties</li> @@ -1365,15 +1382,26 @@ interface offers a representation of the <span>named flow</span>.</p> <pre class="idl"> interface <a href="#dom-namedflow">NamedFlow</a> { - readonly attribute boolean <a href="dom-namedflow-overflow">overflow</a>; -}; - -</pre> + 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-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. A <code class="idl">NamedFlow</code> object is live.</p> + + <p>The <dfn id="dom-namedflow-contentnodes">contentNodes</dfn> property 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. + </p> + + <p>The <dfn id="dom-namedflow-getregionsbycontentnodes">getRegionsByContentNode()</dfn> method gets a + collection of regions that contain at least part of the target content node. This can be used + to navigate by bookmark in paginated view: the method returns regions containing the + bookmarked element, which are then passed to pagination UI to show desired region or page.</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 @@ -1474,7 +1502,7 @@ <p>Region <a href="http://www.w3.org/TR/DOM-Level-3-Events/#glossary-event">Event Targets</a> dispatch <code class="idl">regionLayoutUpdate</code> events when there is a possible layout change of their named flow segment.</p> - <div class='issue-marker'><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-10should-the-regionlayoutupdate-event-by-sync-or-async">I-10</a></div> + <div class='issue-marker'><a href="http://wiki.csswg.org/spec/css3-regions?&#issue-10should-the-regionlayoutupdate-event-by-sync-or-async">Issue-10</a></div> <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> @@ -1631,6 +1659,7 @@ explained in this <a href="http://lists.w3.org/Archives/Public/www-style/2011Oct/0576.html">email</a>. Also allowed the 'inherit' value on 'flow-from' and 'flow-into' (same email).</li> <li>Added note about nested region styling following <a href="http://lists.w3.org/Archives/Public/www-style/2011Oct/0650.html">a mailing list discussion</a>.</li> + <li>Added additional DOM interface following <a href="http://www.w3.org/Style/CSS/Tracker/actions/350">Action 350</a>.</li> </ul> <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
Received on Wednesday, 26 October 2011 01:27:45 UTC