W3C home > Mailing lists > Public > public-css-commits@w3.org > October 2011

csswg/css3-regions Overview.html,1.22,1.23 Overview.src.html,1.24,1.25 alternate-spec-style.css,1.8,1.9

From: Vincent Hardy via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 26 Oct 2011 01:27:42 +0000
To: public-css-commits@w3.org
Message-Id: <E1RIsHO-0007ZO-SL@lionel-hutz.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 @@
    &lt;object&gt;, &lt;embed&gt;</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 &lsquo;<a
    href="#flow-into"><code class=property>flow-into</code></a>&rsquo;
@@ -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 &lsquo;<a href="#flow-from"><code
    class=property>flow-from</code></a>&rsquo; 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 &lsquo;<code class=css>@region</code>&rsquo; 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 &lt;ifram&gt;, &lt;object&gt;, &lt;embed&gt;</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 &lt;iframe&gt;, &lt;object&gt;
         and &lt;embed&gt; 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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 26 October 2011 01:27:45 GMT