Skip to content

Commit 87ecd4e

Browse files
vhardyvhardy
committed
Overview.html
1 parent 6293777 commit 87ecd4e

3 files changed

Lines changed: 53 additions & 48 deletions

File tree

‎css3-regions/Overview.src.html‎

Lines changed: 49 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -1751,15 +1751,7 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
17511751
scripts to reference a <code class="idl">NamedFlow</code> object representation
17521752
of a <span>named flow</span>.</p>
17531753

1754-
<p>The possible states for a <span>named flow</span> are described in the following
1755-
figure. These states are referenced in subsequent text.</p>
1756-
1757-
<div class="figure">
1758-
<img src="images/named-flow-states.svg" alt="NamedFlow states" width="600px" />
1759-
<p class="caption"><span>named flow</span> states and transitions</p>
1760-
</div>
1761-
1762-
<p>An addition method and attribute on the <a href=
1754+
<p>An additional method and an additional attribute on the <a href=
17631755
"http://www.w3.org/TR/dom/#interface-document"><code class=
17641756
"idl">Document</code></a> interface provide access to <span>named flows</span>.</p>
17651757

@@ -1774,13 +1766,11 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
17741766
<p>The <dfn id="document-namedflows"><code class="idl">namedFlows</code></dfn> attribute on the <a href=
17751767
"http://www.w3.org/TR/dom/#interface-document"><code class=
17761768
"idl">Document</code></a> interface returns the live list of all the current <span>named
1777-
flows</span> in the document.</p>
1769+
flows</span> in the document. </p>
17781770

17791771
<p>The <code class="idl">namedFlows</code> collection must include all <span>named flows</span>
1780-
that are currently in the <code>CREATED</code> and <code>CREATED-REFERENCED</code> states.
1781-
The list may include <span>named flows</span>
1782-
that are in the <code>REFERENCED</code> state. The list
1783-
may also include <span>named flows</span> that are in the STALE state.</p>
1772+
that are currently in the <code>CREATED</code> state.
1773+
The list must not include <span>named flows</span> that are in the <code>NULL</code> state. </p>
17841774

17851775
<p>The <dfn id="document-getflowbyname"><code class="idl">getFlowByName</code></dfn> method on the <a href=
17861776
"http://www.w3.org/TR/dom/#interface-document"><code class=
@@ -1790,19 +1780,10 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
17901780

17911781
<ul>
17921782
<li><code class="idl">NULL</code>: the user agent must return <code>null</code>.</li>
1793-
<li><code class="idl">STALE</code>: the user agent may return null or a valid
1794-
<code class="idl">NamedFlow</code> instance.
1795-
If the user agent returns a valid instance, subsequent calls to the <code class="idl">getFlowByName</code> method
1796-
for the same name argument must return the same object instance, no matter what the state of the
1797-
<span>named flow</span> is.</li>
1798-
<li><code class="idl">CREATED</code> or <code class="idl">CREATED-REFERENCED</code>: the
1799-
user agent must return a valid <code class="idl">NamedFlow</code> instance.</li>
1800-
<li><code class="idl">REFERENCED</code>: the user agent may return <code>null</code> or it may return a
1801-
valid <code class="idl">NamedFlow</code> instance. If the user agent returns a
1802-
valid object, subsequent calls to the <code class="idl">getFlowByName</code> method
1803-
with the same name argument must return the same object instance, no matter what the state of the
1804-
<span>named flow</span> is.</li>
1783+
<li><code class="idl">CREATED</code>: the user agent must return a valid
1784+
<code class="idl">NamedFlow</code> instance.</li>
18051785
</ul>
1786+
18061787

18071788
<p>The <dfn id="dom-named-flow-collection"><code class="idl">NamedFlowCollection</code></dfn>
18081789
interface provides a list of current <code class="idl">NamedFlow</code> instances in the
@@ -1824,11 +1805,22 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
18241805
indices in the range <code>0 ≤ index < collection.length</code>.</p>
18251806

18261807
<p>The <dfn id="dom-named-flow"><code class="idl">NamedFlow</code></dfn>
1827-
interface offers a representation of the <span>named flow</span>. A <code class="idl">NamedFlow</code>
1828-
object is live meaning that it always represents the <span>named flow</span> with the corresponding
1829-
name, even if that <span>named flow</span> has transitioned to the <code>REFERENCED</code> or
1830-
the <code>STALE</code> states.</p>
1831-
1808+
interface offers a representation of a <span>named flow</span> instance.</p>
1809+
1810+
<p>The <code class="idl">NamedFlow</code> interface
1811+
can be used for different purposes.
1812+
For example, the <code>getRegionsByContent()</code> method
1813+
can help navigate by bookmark:
1814+
a script can find the <span>region</span>s
1815+
that display a particular anchor
1816+
and bring them to view.</p>
1817+
1818+
<p>Likewise, the interface allows authors
1819+
to check if all content has been fitted
1820+
into existing regions.
1821+
If it has, the <code>overset</code> attribute
1822+
would be false.</p>
1823+
18321824
<pre class="idl">
18331825
interface <a href="#dom-named-flow">NamedFlow</a> implements <a href="http://www.w3.org/TR/dom/#interface-eventtarget">EventTarget</a> {
18341826
readonly attribute DOMString <a href="#dom-named-flow-name">name</a>;
@@ -1889,19 +1881,32 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
18891881
is a static sequence
18901882
in document order.</p>
18911883

1892-
<p>The <code class="idl">NamedFlow</code> interface
1893-
can be used for different purposes.
1894-
For example, the <code>getRegionsByContent()</code> method
1895-
can help navigate by bookmark:
1896-
a script can find the <span>region</span>s
1897-
that display a particular anchor
1898-
and bring them to view.</p>
1899-
1900-
<p>Likewise, the interface allows authors
1901-
to check if all content has been fitted
1902-
into existing regions.
1903-
If it has, the <code>overset</code> attribute
1904-
would be false.</p>
1884+
1885+
<p>The <span>named flow</span> states are :</p>
1886+
1887+
<ul>
1888+
<li><code class="idl">NULL</code>: the <span>named flow</span> is not referenced
1889+
by any 'flow-into' or 'flow-from' computed value.</li>
1890+
<li><code class="idl">CREATED</code>: the <span>named flow</span> is referenced by
1891+
at least one 'flow-into' or 'flow-from' computed value.</li>
1892+
</ul>
1893+
1894+
<p>A <code class="idl">NamedFlow</code>
1895+
object is live: it always represents the <span>named flow</span> with the corresponding
1896+
name even if that <span>named flow</span> has transitioned to the <code>NULL</code> state.</p>
1897+
1898+
<p>If a script holds a reference to a <code class="idl">NamedFlow</code> instance that
1899+
has entered the <code>NULL</code> state, its attributes and methods should behave
1900+
as follows:</p>
1901+
1902+
<ul>
1903+
<li>the <code class="idl">name</code> attribute returns its value as normal.</li>
1904+
<li>the <code class="idl">overset</code> attribute returns <code class="idl">true</code>.</li>
1905+
<li>the <code class="idl">getRegions</code> method returns an empty sequence.</li>
1906+
<li>the <code class="idl">firstEmptyRegionIndex</code> attribute returns <code class="idl">-1</code>.</li>
1907+
<li>the <code class="idl">getContent()</code> method returns an empty <code class="idl">NodeList</code> instance.</li>
1908+
<li>the <code class="idl">getRegionsByContentNode()</code> method retuns an empty sequence.</li>
1909+
</ul>
19051910

19061911
<h3 id="the-region-interface">The Region interface</h3>
19071912

‎css3-regions/images/intro-example-layout.graffle‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -247,7 +247,7 @@
247247
</dict>
248248
<dict>
249249
<key>Bounds</key>
250-
<string>{{465.39474, 21}, {32.210529, 32.210526}}</string>
250+
<string>{{457.39474, 20}, {32.210529, 32.210526}}</string>
251251
<key>Class</key>
252252
<string>ShapedGraphic</string>
253253
<key>FontInfo</key>
@@ -907,9 +907,9 @@
907907
<key>MasterSheets</key>
908908
<array/>
909909
<key>ModificationDate</key>
910-
<string>2012-04-07 00:00:32 +0000</string>
910+
<string>2012-04-20 15:55:43 +0000</string>
911911
<key>Modifier</key>
912-
<string>Alan Stearns</string>
912+
<string>vhardy</string>
913913
<key>NotesVisible</key>
914914
<string>NO</string>
915915
<key>Orientation</key>

0 commit comments

Comments
 (0)