Skip to content

Commit d4f0463

Browse files
committed
Edits to auto sizing model
1 parent 02de026 commit d4f0463

2 files changed

Lines changed: 54 additions & 37 deletions

File tree

css3-regions/Overview.html

Lines changed: 34 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -438,8 +438,7 @@ <h2 class="no-num no-toc" id=table-of-contents>Table of contents</h2>
438438
</span>The Region Flow Content Box (RFBC)</a>
439439

440440
<li><a href="#rfbc-width-computation"><span class=secno>7.2. </span>RFCB
441-
intrinsic &lsquo;<code class=property>width</code>&rsquo;
442-
resolution</a>
441+
&lsquo;<code class=property>width</code>&rsquo; resolution</a>
443442

444443
<li><a href="#rfcb-height-computation"><span class=secno>7.3.
445444
</span>RFCB intrinsic &lsquo;<code class=property>height</code>&rsquo;
@@ -2371,35 +2370,42 @@ <h3 id=regions-flow-content-box><span class=secno>7.1. </span>The Region
23712370
<p>Laying out a <span>region</span> box follows the normal processing rules
23722371
as any other container box.
23732372

2374-
<p>However, the <span>RFCB</span> behaves like a <a
2373+
<p>The <span>RFCB</span> behaves like a <a
2374+
href="http://www.w3.org/TR/CSS2/visudet.html#blockwidth">block-level
2375+
non-replaced element</a> in normal flow with regards to its &lsquo;<code
2376+
class=property>width</code>&rsquo;.
2377+
2378+
<p>The <span>RFCB</span> behaves like a <a
23752379
href="http://www.w3.org/TR/CSS2/conform.html#replaced-element">replaced
2376-
element</a> and computing the <span>RFCB</span>&lsquo;<code class=css>s <a
2377-
href="">intrinsic dimensions</a> require special processing as described
2378-
in the following sections.</code>
2380+
element</a> with regards to its height and computing the
2381+
<span>RFCB</span>&lsquo;<code class=css>s <a href="">intrinsic height</a>
2382+
require special processing as described in the following sections.</code>
23792383

2380-
<h3 id=rfbc-width-computation><span class=secno>7.2. </span>RFCB intrinsic
2384+
<h3 id=rfbc-width-computation><span class=secno>7.2. </span>RFCB
23812385
&rsquo;width' resolution</h3>
23822386

2383-
<p>The intrinsic &lsquo;<code class=property>width</code>&rsquo; of an
2384-
<span>RFCB</span> is its <code class=css>fill-content</code> &lsquo;<code
2385-
class=property>width</code>&rsquo; (also called <em>shrink-to-fit</em>),
2386-
as <a href="">defined</a> in the CSS Writing Modes Module <a
2387-
href="#CSS3-WRITING-MODES"
2388-
rel=biblioentry>[CSS3-WRITING-MODES]<!--{{!CSS3-WRITING-MODES}}--></a>)
2389-
which is computed based on the entire associated <a
2390-
href="#named-flow0">named flow</a> content.
2391-
2392-
<p>As a result, the intrinsic &lsquo;<code
2393-
class=property>width</code>&rsquo; for all <span>region</span>&lsquo;<code
2394-
class=css>s <span>RFCB</span> is the same.</code>
2387+
<p>The &lsquo;<code class=property>width</code>&rsquo; of an
2388+
<span>RFCB</span> is based on its <code class=css>min-content</code>,
2389+
<code class=css>max-content</code>, <code class=css>fill-available</code>
2390+
and <code class=css>fill-content</code> (also called
2391+
<em>shrink-to-fit</em>) sizes, as <a href="">defined</a> in the CSS
2392+
Writing Modes Module <a href="#CSS3-WRITING-MODES"
2393+
rel=biblioentry>[CSS3-WRITING-MODES]<!--{{!CSS3-WRITING-MODES}}--></a>).
2394+
For an <span>RFCB</span>, these sizes are computed based on the entire
2395+
associated <a href="#named-flow0">named flow</a> content.
23952396

23962397
<p>This is consistent with the <a
2397-
href="http://www.w3.org/TR/css3-break/#varying-size-boxes">Box model for
2398+
href="http://www.w3.org/TR/css3-break/#varying-size-boxes">box model for
23982399
breaking</a> (<a href="#CSS3-BREAK"
23992400
rel=biblioentry>[CSS3-BREAK]<!--{{!CSS3-BREAK}}--></a>).
24002401

2402+
<p>This means that all <span>regions</span> associated with a <a
2403+
href="#named-flow0">named flow</a> share the same <code
2404+
class=css>min-content</code> and <code class=css>max-content</code>
2405+
measures.
2406+
24012407
<h3 id=rfcb-height-computation><span class=secno>7.3. </span>RFCB intrinsic
2402-
&rsquo;height' resolution</h3>
2408+
&lsquo;<code class=property>height</code>&rsquo; resolution</h3>
24032409

24042410
<p>The resolution of an RFCB's &lsquo;<code
24052411
class=property>height</code>&rsquo; requires a two phase process. This
@@ -2411,11 +2417,11 @@ <h4 id="rfcb=height-resolution-phase-1"><span class=secno>7.3.1.
24112417
</span>RFCB intrinsic &lsquo;<code class=property>height</code>&rsquo;
24122418
resolution, Phase 1</h4>
24132419

2414-
<p>The document is laid out using a <a
2420+
<p>The document is laid out with a <a
24152421
href="http://www.w3.org/TR/CSS2/cascade.html#used-value">used</a> height
24162422
of zero for all <span>RFCB</span>s. In this phase, the content of <a
24172423
href="#named-flow0">named flows</a> is not laid out in
2418-
<span>regions</span>. This phase yields a resolved position and sizes for
2424+
<span>regions</span>. This phase yields resolved position and sizes for
24192425
all regions and their RFCBs in the document.
24202426

24212427
<h4 id=rfcb-height-resolution-phase-2><span class=secno>7.3.2. </span>RFCB
@@ -2424,7 +2430,7 @@ <h4 id=rfcb-height-resolution-phase-2><span class=secno>7.3.2. </span>RFCB
24242430
<p><a href="#named-flow0">Named flows</a> are laid out in
24252431
<span>regions</span>. For <span>regions</span> whose <a
24262432
href="http://www.w3.org/TR/CSS2/cascade.html#computed-value">computed</a>
2427-
&lsquo;<code class=property>height</code>&rsquo; value is <code
2433+
&lsquo;<code class=property>height</code>&rsquo; is <code
24282434
class=css>auto</code>, the user agent computes a new <a
24292435
href="http://www.w3.org/TR/CSS2/cascade.html#used-value">used</a>
24302436
&lsquo;<code class=property>height</code>&rsquo; for the <span>RFCB</span>
@@ -2613,6 +2619,10 @@ <h3 id="changes_from_June_09_2011"><span class=secno>12.1. </span>Changes
26132619

26142620
<li>Added section about getClientRects(), getBoundingClientRect(),
26152621
offsetWidth, offsetHeight, offsetTop and offsetLeft.
2622+
2623+
<li>Added &lsquo;<code class=css>Regions visual formatting
2624+
details</code>&rsquo; section to better describe the model for resolving
2625+
auto sizing on regions.
26162626
</ul>
26172627

26182628
<h3 id="changes_from_June_09_2011"><span class=secno>12.2. </span>Changes

css3-regions/Overview.src.html

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1978,20 +1978,27 @@ <h3 id="regions-flow-content-box">The Region Flow Content Box (RFBC)</h3>
19781978
<p>Laying out a <span>region</span> box follows the normal processing rules as any other
19791979
container box.</p>
19801980

1981-
<p>However, the <span>RFCB</span> behaves like a <a href="http://www.w3.org/TR/CSS2/conform.html#replaced-element">replaced
1982-
element</a> and computing the <span>RFCB</span>'s <a href="">intrinsic dimensions</a>
1981+
<p>The <span>RFCB</span> behaves like a <a href="http://www.w3.org/TR/CSS2/visudet.html#blockwidth">block-level
1982+
non-replaced element</a> in normal flow with regards to its 'width'.</p>
1983+
1984+
<p>The <span>RFCB</span> behaves like a <a href="http://www.w3.org/TR/CSS2/conform.html#replaced-element">replaced
1985+
element</a> with regards to its height and computing the <span>RFCB</span>'s <a href="">intrinsic height</a>
19831986
require special processing as described in the following sections.</p>
19841987

1985-
<h3 id="rfbc-width-computation">RFCB intrinsic 'width' resolution</h3>
1986-
1987-
<p>The intrinsic 'width' of an <span>RFCB</span> is its
1988-
<code class="css">fill-content</code> 'width' (also called <em>shrink-to-fit</em>),
1989-
as <a href="">defined</a> in the CSS Writing Modes Module [[!CSS3-WRITING-MODES]]) which is
1988+
<h3 id="rfbc-width-computation">RFCB 'width' resolution</h3>
1989+
1990+
<p>The 'width' of an <span>RFCB</span> is based on its
1991+
<code class="css">min-content</code>, <code class="css">max-content</code>,
1992+
<code class="css">fill-available</code> and <code class="css">fill-content</code>
1993+
(also called <em>shrink-to-fit</em>) sizes,
1994+
as <a href="">defined</a> in the CSS Writing Modes Module [[!CSS3-WRITING-MODES]]). For
1995+
an <span>RFCB</span>, these sizes are
19901996
computed based on the entire associated <span>named flow</span> content.</p>
1991-
<p>As a result, the intrinsic 'width' for all <span>region</span>'s <span>RFCB</span>
1992-
is the same.</p>
19931997

1994-
<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>
1998+
<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>
1999+
2000+
<p>This means that all <span>regions</span> associated with a <span>named flow</span> share the
2001+
same <code class="css">min-content</code> and <code class="css">max-content</code> measures.</p>
19952002

19962003
<h3 id="rfcb-height-computation">RFCB intrinsic 'height' resolution</h3>
19972004

@@ -2002,16 +2009,16 @@ <h3 id="rfcb-height-computation">RFCB intrinsic 'height' resolution</h3>
20022009

20032010
<h4 id="rfcb=height-resolution-phase-1">RFCB intrinsic 'height' resolution, Phase 1</h4>
20042011

2005-
<p>The document is laid out using a
2012+
<p>The document is laid out with a
20062013
<a href="http://www.w3.org/TR/CSS2/cascade.html#used-value">used</a> height of zero
20072014
for all <span>RFCB</span>s. In this phase, the content of <span>named flows</span> is not laid out in
2008-
<span>regions</span>. This phase yields a resolved position and sizes for all regions and
2015+
<span>regions</span>. This phase yields resolved position and sizes for all regions and
20092016
their RFCBs in the document.</p>
20102017

20112018
<h4 id="rfcb-height-resolution-phase-2">RFCB 'height' resolution Phase 2</h4>
20122019

20132020
<p><span>Named flows</span> are laid out in <span>regions</span>. For <span>regions</span> whose
2014-
<a href="http://www.w3.org/TR/CSS2/cascade.html#computed-value">computed</a> 'height' value
2021+
<a href="http://www.w3.org/TR/CSS2/cascade.html#computed-value">computed</a> 'height'
20152022
is <code class="css">auto</code>, the
20162023
user agent computes a new <a href="http://www.w3.org/TR/CSS2/cascade.html#used-value">used</a>
20172024
'height' for the <span>RFCB</span> using the remainder of the flow and accounting for

0 commit comments

Comments
 (0)