- 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