Skip to content

Commit 5de9017

Browse files
committed
Editorial changes followig Mihnea Vlad Ovedine's review
1 parent 4b9cc27 commit 5de9017

2 files changed

Lines changed: 30 additions & 25 deletions

File tree

css3-regions/Overview.html

Lines changed: 19 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -826,7 +826,7 @@ <h3 id=named-flow><span class=secno>2.2. </span>Named flow</h3>
826826
href="#flow-into"><code class=property>flow-into</code></a>&rsquo;
827827
property. The elements in a named flow are laid out in the chain of
828828
regions that are associated with this named flow. <span
829-
title=region>Regions</span> are organized in to a <span
829+
title=region>Regions</span> are organized into a <span
830830
title=region-chain>region chain</span> according to the document order.
831831

832832
<p>Content from a named flow is broken up between regions according to the
@@ -850,10 +850,10 @@ <h3 id=regions-flow-breaking-rules><span class=secno>2.3. </span>Regions
850850
<p>Each region in turn consumes content from its associated <a
851851
href="#named-flow0">named flow</a>. The named flow content is positioned
852852
in the <dfn id=current-region title=current-region>current region</dfn>
853-
until a natural or forced region break occurs, at which point the <a
854-
href="#current-region" title=current-region>current region</a> becomes the
855-
next one in the <span title=region-chain>region chain</span>. If there are
856-
no more <span>region</span>s in the region chain and there is still
853+
until a natural or forced region break occurs, at which point the next
854+
region in the <span title=region-chain>region chain</span> becomes the <a
855+
href="#current-region" title=current-region>current region</a>. If there
856+
are no more <span>region</span>s in the region chain and there is still
857857
content in the flow, the positioning of the remaining content is
858858
controlled by the &lsquo;<a href="#region-overflow"><code
859859
class=property>region-overflow</code></a>&rsquo; property on the last
@@ -990,8 +990,8 @@ <h3 id=the-flow-into-property><span class=secno>3.1. </span>The &lsquo;<a
990990
<p>The edges of the first region in a region chain associated with a named
991991
flow establish the rectangle that is the <a
992992
href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">containing
993-
block</a> used for absolutely positioned elements in the name named flow
994-
which do not have an ancestor with a &lsquo;<code
993+
block</a> used for absolutely positioned elements in the named flow which
994+
do not have an ancestor with a &lsquo;<code
995995
class=property>position</code>&rsquo; of &lsquo;<code
996996
class=property>absolute</code>&rsquo;, &lsquo;<code
997997
class=property>relative</code>&rsquo; or &lsquo;<code
@@ -2095,7 +2095,7 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
20952095
href="#dom-namedflow-overset">overset</a>;
20962096
sequence&lt;<a
20972097
href="#region-interface">Region</a>&gt; getRegions();
2098-
readonly attribute integer emptyRegionsIndex;
2098+
readonly attribute integer firstEmptyRegionIndex;
20992099
<a
21002100
href="http://www.w3.org/TR/dom/#interface-nodelist">NodeList</a> getContent();
21012101
sequence&lt;<a
@@ -2117,20 +2117,22 @@ <h3 id=the-namedflow-interface><span class=secno>6.1. </span>The NamedFlow
21172117
href="#named-flow0">named flow</a>. Note that the returned values is a
21182118
static sequence.
21192119

2120-
<p>The <dfn id=dom-namedflow-unusedregionindex>emptyRegionsIndex</dfn> is
2121-
the index of the first region in the region sequence with the <a
2120+
<p>The <dfn id=dom-namedflow-unusedregionindex>firstEmptyRegionIndex</dfn>
2121+
is the index of the first region in the region sequence with the <a
21222122
href="#dom-region-regionoverset"><code>regionOverset</code></a> attribute
21232123
set to <code>empty</code>. If all regions have the <a
21242124
href="#dom-region-regionoverset"><code>regionOverset</code></a> attribute
21252125
set to <code>fit</code> or <a
21262126
href="#dom-namedflow-overset"><code>overset</code></a>, the value for <a
2127-
href="#dom-namedflow-unusedregionindex"><code>emptyRegionsIndex</code></a>
2127+
href="#dom-namedflow-unusedregionindex"><code>firstEmptyRegionIndex</code></a>
21282128
is <code>-1</code>.
21292129

21302130
<p>The <dfn id=dom-namedflow-getcontent>getContent()</dfn> methods returns
21312131
an ordered collection of nodes that constitute the named flow. The
21322132
returned list is a static snapshot of the named flow content at the time
2133-
the method is invoked.
2133+
the method is invoked. This list contains the elements that were moved to
2134+
the named flow but not their descendants (unless the descendants are
2135+
themselves moved to the named flow).
21342136

21352137
<p>The <dfn
21362138
id=dom-namedflow-getregionsbycontentnodes>getRegionsByContent()</dfn>
@@ -2420,8 +2422,9 @@ <h4 id=rfbc-width-computation><span class=secno>7.1.1. </span>RFCB
24202422
<span>RFCB</span> is based on its <code class=css>min-content</code>,
24212423
<code class=css>max-content</code>, <code class=css>fill-available</code>
24222424
and <code class=css>fill-content</code> (also called
2423-
<em>shrink-to-fit</em>) sizes, as <a href="">defined</a> in the CSS
2424-
Writing Modes Module <a href="#CSS3-WRITING-MODES"
2425+
<em>shrink-to-fit</em>) sizes, as <a
2426+
href="http://www.w3.org/TR/css3-writing-modes/#intrinsic-sizing">defined</a>
2427+
in the CSS Writing Modes Module <a href="#CSS3-WRITING-MODES"
24252428
rel=biblioentry>[CSS3-WRITING-MODES]<!--{{!CSS3-WRITING-MODES}}--></a>).
24262429
<strong>These sizes are computed based on the <em>entire</em> associated
24272430
<a href="#named-flow0">named flow</a> content</strong>.
@@ -3335,8 +3338,8 @@ <h2 class=no-num id=index>Index</h2>
33353338
<li>current-region, <a href="#current-region"
33363339
title=current-region><strong>2.3.</strong></a>
33373340

3338-
<li>emptyRegionsIndex, <a href="#dom-namedflow-unusedregionindex"
3339-
title=emptyRegionsIndex><strong>6.1.</strong></a>
3341+
<li>firstEmptyRegionIndex, <a href="#dom-namedflow-unusedregionindex"
3342+
title=firstEmptyRegionIndex><strong>6.1.</strong></a>
33403343

33413344
<li>flowFrom, <a href="#dom-region-flowfrom"
33423345
title=flowFrom><strong>6.2.</strong></a>

css3-regions/Overview.src.html

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -604,7 +604,7 @@ <h3 id="named-flow">Named flow</h3>
604604
<p>Elements are placed into a named flow with the 'flow-into' property.
605605
The elements in a named flow are laid out in the chain of regions that
606606
are associated with this named flow. <span title=
607-
"region">Regions</span> are organized in to a <span title=
607+
"region">Regions</span> are organized into a <span title=
608608
"region-chain">region chain</span> according to the document order.</p>
609609

610610
<p>Content from a named flow is broken up between regions according to the
@@ -627,9 +627,9 @@ <h3 id="regions-flow-breaking-rules">Regions flow breaking rules</h3>
627627
<p>Each region in turn consumes content from its
628628
associated <span>named flow</span>. The named flow content is
629629
positioned in the <dfn title="current-region">current region</dfn> until a
630-
natural or forced region break occurs, at which point the <span title=
631-
"current-region">current region</span> becomes the next one in the
632-
<span title="region-chain">region chain</span>. If there are no more
630+
natural or forced region break occurs, at which point the next
631+
region in the <span title="region-chain">region chain</span>
632+
becomes the <span title="current-region">current region</span>. If there are no more
633633
<span>region</span>s in the region chain and there is still content in the
634634
flow, the positioning of the remaining content is controlled by the
635635
'region-overflow' property on the last <span>region</span> in the
@@ -760,7 +760,7 @@ <h3 id="the-flow-into-property">The 'flow-into' property</h3>
760760
<p>The edges of the first region in a region chain associated with a named flow establish
761761
the rectangle that is the
762762
<a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">containing block</a>
763-
used for absolutely positioned elements in the name named flow which do not have an
763+
used for absolutely positioned elements in the named flow which do not have an
764764
ancestor with a 'position' of 'absolute', 'relative' or 'fixed' (see [[!CSS21]]). That
765765
first region rectangle is used as the containing block instead of the initial containing block.</p>
766766

@@ -1764,7 +1764,7 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
17641764
readonly attribute DOMString name;
17651765
readonly attribute boolean <a href="#dom-namedflow-overset">overset</a>;
17661766
sequence&lt;<a href="#region-interface">Region</a>&gt; getRegions();
1767-
readonly attribute integer emptyRegionsIndex;
1767+
readonly attribute integer firstEmptyRegionIndex;
17681768
<a href="http://www.w3.org/TR/dom/#interface-nodelist">NodeList</a> getContent();
17691769
sequence&lt;<a href="#region-interface">Region</a>&gt; getRegionsByContent(<a href="http://www.w3.org/TR/dom/#interface-node">Node</a> node);
17701770
};</pre>
@@ -1780,15 +1780,17 @@ <h3 id="the-namedflow-interface">The NamedFlow interface</h3>
17801780
method returns the sequence of regions in the <span>region chain</span> associated
17811781
with the <span>named flow</span>. Note that the returned values is a static sequence.</p>
17821782

1783-
<p>The <dfn id="dom-namedflow-unusedregionindex">emptyRegionsIndex</dfn> is the index
1783+
<p>The <dfn id="dom-namedflow-unusedregionindex">firstEmptyRegionIndex</dfn> is the index
17841784
of the first region in the region sequence with the <code>regionOverset</code> attribute
17851785
set to <code>empty</code>. If all regions have the <code>regionOverset</code> attribute
17861786
set to <code>fit</code> or <code>overset</code>, the value for
1787-
<code>emptyRegionsIndex</code> is <code>-1</code>.</p>
1787+
<code>firstEmptyRegionIndex</code> is <code>-1</code>.</p>
17881788

17891789
<p>The <dfn id="dom-namedflow-getcontent">getContent()</dfn> methods returns
17901790
an ordered collection of nodes that constitute the named flow. The returned list
17911791
is a static snapshot of the named flow content at the time the method is invoked.
1792+
This list contains the elements that were moved to the named flow but not their
1793+
descendants (unless the descendants are themselves moved to the named flow).
17921794
</p>
17931795

17941796
<p>The <dfn id="dom-namedflow-getregionsbycontentnodes">getRegionsByContent()</dfn> method returns the
@@ -1999,7 +2001,7 @@ <h4 id="rfbc-width-computation">RFCB 'width' resolution</h4>
19992001
<code class="css">min-content</code>, <code class="css">max-content</code>,
20002002
<code class="css">fill-available</code> and <code class="css">fill-content</code>
20012003
(also called <em>shrink-to-fit</em>) sizes,
2002-
as <a href="">defined</a> in the CSS Writing Modes Module [[!CSS3-WRITING-MODES]]). <strong>These sizes are
2004+
as <a href="http://www.w3.org/TR/css3-writing-modes/#intrinsic-sizing">defined</a> in the CSS Writing Modes Module [[!CSS3-WRITING-MODES]]). <strong>These sizes are
20032005
computed based on the <em>entire</em> associated <span>named flow</span> content</strong>.</p>
20042006

20052007
<p>This is consistent with the <a href="http://www.w3.org/TR/css3-break/#varying-size-boxes">box model for breaking</a> ([[!CSS3-BREAK]]).</p>

0 commit comments

Comments
 (0)