- From: Vincent Hardy via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 01 Feb 2012 08:43:22 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-regions
In directory hutz:/tmp/cvs-serv28533
Modified Files:
Overview.html Overview.src.html
Log Message:
Added all issue references to Bugzilla. Added proposal to address https://www.w3.org/Bugs/Public/show_bug.cgi?id=15828
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-regions/Overview.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -d -r1.45 -r1.46
--- Overview.html 31 Jan 2012 13:51:39 -0000 1.45
+++ Overview.html 1 Feb 2012 08:43:20 -0000 1.46
@@ -55,7 +55,7 @@
display: none;
}
- @media screen and (min-width: 58em){
+ @media screen and (min-width: 68em){
.issue-marker {
position: absolute;
width: 20ex;
@@ -64,7 +64,7 @@
}
}
- @media screen and (max-width: 58em){
+ @media screen and (max-width: 68em){
.issue-marker {
}
@@ -126,14 +126,14 @@
<h1 id=css-regions-module>CSS Regions Module Level 3</h1>
- <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 31 January
+ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 1 February
2012</h2>
<dl>
<dt>This version:
<dd><a
- href="http://www.w3.org/TR/2012/ED-css3-regions-20120131/">http://www.w3.org/csswg/css3-regions</a>
+ href="http://www.w3.org/TR/2012/ED-css3-regions-20120201/">http://www.w3.org/csswg/css3-regions</a>
<dt>Latest version:
@@ -901,6 +901,15 @@
<div class=issue-details>
<p class=short-desc>Should regions be non-breakable?</p>
</div>
+ <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?15824">Bug-15824</a>
+ <div class=issue-details>
+ <p class=short-desc>Should regions not create a new stacking context?</p>
+ </div>
+ <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?15824">Bug-15827</a>
+ <div class=issue-details>
+ <p class=short-desc>Specify behavior of stacking contexts that are split
+ between regions</p>
+ </div>
</div>
<p><span title=region>Regions</span> create a new <a
@@ -1009,7 +1018,7 @@
<table class=propdef summary="break-before property definition">
<tbody>
<tr>
- <td><em>Name:</em>
+ <td><a href="#dom-namedflow-name"><em>Name:</em></a>
<td><dfn id=break-before>break-before</dfn>
@@ -1053,7 +1062,7 @@
<table class=propdef summary="break-after property definition">
<tbody>
<tr>
- <td><em>Name:</em>
+ <td><a href="#dom-namedflow-name"><em>Name:</em></a>
<td><dfn id=break-after>break-after</dfn>
@@ -1097,7 +1106,7 @@
<table class=propdef summary="break-inside property definition">
<tbody>
<tr>
- <td><em>Name:</em>
+ <td><a href="#dom-namedflow-name"><em>Name:</em></a>
<td><dfn id=break-inside>break-inside</dfn>
@@ -1164,7 +1173,7 @@
<table class=propdef summary="break-after property definition">
<tbody>
<tr>
- <td><em>Name:</em>
+ <td><a href="#dom-namedflow-name"><em>Name:</em></a>
<td><dfn id=region-overflow>region-overflow</dfn>
@@ -1639,10 +1648,9 @@
</div>
</div>
- <p>The <code class=idl>getFlowByName</code> method on the <a
+ <p>Supplemental methods on the <a
href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code
- class=idl>Document</code></a> interface provides access to the document's
- <a href="#named-flow0">named flow</a> instances.
+ class=idl>Document</code></a> interface provide access to named flows.
<pre class=idl>
[Supplemental] interface <a
@@ -1650,15 +1658,62 @@
<a
href="#dom-namedflow">NamedFlow</a> getFlowByName(<a
href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name);
+ <a
+ href="#dom-namedflow-collection">NamedFlowCollection</a> getNamedFlows();
};
</pre>
+ <p>The <code class=idl>getNamedFlows</code> method on the <a
+ href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code
+ class=idl>Document</code></a> interface returns the list of all the <a
+ href="#named-flow0">named flow</a>s in the document.
+
+ <p>The <code class=idl>getFlowByName</code> method on the <a
+ href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code
+ class=idl>Document</code></a> interface provides access to the document's
+ <a href="#named-flow0">named flow</a> instances.
+
+ <div class=issue-marker> <a
+ href="https://www.w3.org/Bugs/Public/show_bug.cgi?15828">Bug-15828</a>
+ <div class=issue-details>
+ <p class=short-desc>Should add a ‘<a
+ href="#dom-namedflow-name"><code class=property>name</code></a>’
+ property on NamedFlow and should have a Document method to get all
+ existing NamedFlow instances.</p>
+ </div>
+ </div>
+
+ <p>The <dfn id=dom-namedflow-collection><code
+ class=idl>NamedFlowCollection</code></dfn> interface provides a list of
+ current <a href="#dom-namedflow"><code class=idl>NamedFlow</code></a>
+ instances in the document. The collection is live and methods operate on
+ the underlying data, not a snapshot of the data.
+
+ <pre class=idl>
+interface NamedFlowCollection {
+ readonly attribute unsigned long length;
+ caller getter <a
+ href="#dom-namedflow">NamedFlow</a> item (in unsigned long index);
+}
+ </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>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>The <dfn id=dom-namedflow><code class=idl>NamedFlow</code></dfn>
interface offers a representation of the <a href="#named-flow0">named
flow</a>.
<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
@@ -1669,13 +1724,17 @@
};
};</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
+ class=idl>NamedFlow</code></a> instance.
+
<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.
+ attribute value 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.
+ <p>The <dfn id=dom-namedflow-contentnodes>contentNodes</dfn> attribute
+ value is 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.
@@ -1924,6 +1983,14 @@
<li>Clarified that the <code>NodeList</code> returned by <a
href="#dom-namedflow-getregionsbycontentnodes"><code>getRegionsByContentNode</code></a>
is live.
+
+ <li>Added a name property to the <a
+ href="#dom-namedflow"><code>NamedFlow</code></a> interface. Added a <a
+ href="#dom-namedflow-collection"><code>NamedFlowCollection</code></a>
+ interface and added a <code>getNamedFlows</code> method on the
+ <code>Document</code> interface, as per <a
+ href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15828">Bug
+ 15828</a>.
</ul>
<h3 id="changes_from_June_09_2011"><span class=secno>10.2. </span>Changes
@@ -2398,12 +2465,29 @@
href="#dom-namedflow-getregionsbycontentnodes"
title="getRegionsByContentNode()"><strong>6.1.</strong></a>
+ <li><a href="#dom-namedflow-collection-item"><code
+ class=idl>item(index)</code></a>, <a
+ href="#dom-namedflow-collection-item"
+ title="item(index)"><strong>6.1.</strong></a>
+
+ <li><a href="#dom-namedflow-collection-length"><code
+ class=idl>length</code></a>, <a href="#dom-namedflow-collection-length"
+ title=length><strong>6.1.</strong></a>
+
+ <li><a href="#dom-namedflow-name"><code class=idl>name</code></a>, <a
+ href="#dom-namedflow-name" title=name><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>
<li>named flow, <a href="#named-flow0"
title="named flow"><strong>2.2.</strong></a>
+ <li><a href="#dom-namedflow-collection"><code
+ class=idl>NamedFlowCollection</code></a>, <a
+ href="#dom-namedflow-collection"
+ title=NamedFlowCollection><strong>6.1.</strong></a>
+
<li><a href="#dom-namedflow-overflow"><code class=idl>overflow</code></a>,
<a href="#dom-namedflow-overflow"
title=overflow><strong>6.1.</strong></a>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-regions/Overview.src.html,v
retrieving revision 1.50
retrieving revision 1.51
diff -u -d -r1.50 -r1.51
--- Overview.src.html 31 Jan 2012 13:51:39 -0000 1.50
+++ Overview.src.html 1 Feb 2012 08:43:20 -0000 1.51
@@ -58,7 +58,7 @@
display: none;
}
- @media screen and (min-width: 58em){
+ @media screen and (min-width: 68em){
.issue-marker {
position: absolute;
width: 20ex;
@@ -67,7 +67,7 @@
}
}
- @media screen and (max-width: 58em){
+ @media screen and (max-width: 68em){
.issue-marker {
}
@@ -733,7 +733,23 @@
<div class="issue-details">
<p class="short-desc">Should regions be non-breakable?</p>
</div>
- </div>
+
+ <a href=
+ "https://www.w3.org/Bugs/Public/show_bug.cgi?15824">Bug-15824</a>
+
+ <div class="issue-details">
+ <p class="short-desc">Should regions not create a new stacking context?</p>
+ </div>
+
+ <a href=
+ "https://www.w3.org/Bugs/Public/show_bug.cgi?15824">Bug-15827</a>
+
+ <div class="issue-details">
+ <p class="short-desc">Specify behavior of stacking contexts that are split between regions</p>
+ </div>
+
+
+ </div>
<p><span title="region">Regions</span> create a new <a href="http://www.w3.org/TR/CSS2/visuren.html#z-index">stacking context</a>. <span title="region">Regions</span> establish a new <a href="http://www.w3.org/TR/CSS2/visuren.html#block-formatting">block formatting Context</a>.</p>
@@ -1431,34 +1447,79 @@
</div>
</div>
- <p>The <code class="idl">getFlowByName</code> method on the <a href=
+ <p>Supplemental methods on the <a href=
"http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code class=
- "idl">Document</code></a> interface provides access to the document's <span
- >named flow</span> instances.</p>
+ "idl">Document</code></a> interface provide access to named flows.</p>
+
<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> getFlowByName(<a href="http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMString">DOMString</a> name);
+ <a href="#dom-namedflow-collection">NamedFlowCollection</a> getNamedFlows();
};
</pre>
+ <p>The <code class="idl">getNamedFlows</code> method on the <a href=
+ "http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code class=
+ "idl">Document</code></a> interface returns the list of all the <span>named
+ flow</span>s in the document.</p>
+
+ <p>The <code class="idl">getFlowByName</code> method on the <a href=
+ "http://www.w3.org/TR/DOM-Level-3-Core/core.html#i-Document"><code class=
+ "idl">Document</code></a> interface provides access to the document's <span
+ >named flow</span> instances.</p>
+
+
+ <div class="issue-marker">
+ <a href=
+ "https://www.w3.org/Bugs/Public/show_bug.cgi?15828">Bug-15828</a>
+
+ <div class="issue-details">
+ <p class="short-desc">Should add a 'name' property on NamedFlow and
+ should have a Document method to get all existing NamedFlow instances.</p>
+ </div>
+ </div>
+
+ <p>The <dfn id="dom-namedflow-collection"><code class="idl">NamedFlowCollection</code></dfn>
+ interface provides a list of current <code class="idl">NamedFlow</code> instances in the
+ document. The collection is live and methods operate on the underlying data, not a snapshot of
+ the data.</p>
+
+ <pre class="idl">
+interface NamedFlowCollection {
+ readonly attribute unsigned long length;
+ caller getter <a href="#dom-namedflow">NamedFlow</a> item (in unsigned long index);
+}
+ </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>
+ <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>
<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>
+
<p>The <dfn id="dom-namedflow-overflow"><code class=
- "idl">overflow</code></dfn> property is true if the named flow does not
+ "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
<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
+ <p>The <dfn id="dom-namedflow-contentnodes">contentNodes</dfn> attribute value is
+ 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>
@@ -1635,6 +1696,9 @@
the corresponding region and added an issue that the model for 'partial' styling needs to
be defined. See <a href="http://lists.w3.org/Archives/Public/www-style/2011Dec/0480.html">mailing list feedback</a>.</li>
<li>Clarified that the <code>NodeList</code> returned by <code>getRegionsByContentNode</code> is live.</li>
+ <li>Added a name property to the <code>NamedFlow</code> interface. Added a <code>NamedFlowCollection</code>
+ interface and added a <code>getNamedFlows</code> method on the <code>Document</code> interface, as
+ per <a href="https://www.w3.org/Bugs/Public/show_bug.cgi?id=15828">Bug 15828</a>.</li>
</ul>
Received on Wednesday, 1 February 2012 08:43:25 UTC