Skip to content

Commit 1283637

Browse files
committed
[css-flexbox] Clarify purpose of Intrinsic Sizing section, as requested by biesi
1 parent 2ddcbf9 commit 1283637

2 files changed

Lines changed: 15 additions & 5 deletions

File tree

css-flexbox/Overview.bs

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2648,9 +2648,14 @@ Definite and Indefinite Sizes</h3>
26482648
<h3 id='intrinsic-sizes'>
26492649
Intrinsic Sizes</h3>
26502650

2651+
The <a>intrinsic sizing</a> of a <a>flex container</a> is used
2652+
to produce various types of content-based automatic sizing,
2653+
such as shrink-to-fit logical widths (which use the ''fit-content'' formula)
2654+
and content-based logical heights (which use the <a>max-content main size</a>).
2655+
26512656
The <dfn>max-content main size</dfn> of a <a>flex container</a>
26522657
is the smallest size the <a>flex container</a> can take
2653-
while maintaining the <a>max-content contributions</a> of its <a>flex items</a>.
2658+
while maintaining the <a>max-content contributions</a> of its <a>flex items</a>:
26542659

26552660
<ol>
26562661
<li>
@@ -2682,7 +2687,7 @@ Intrinsic Sizes</h3>
26822687
is calculated identically to the <a>max-content main size</a>,
26832688
except that the <a>flex item’s</a> <a>min-content contribution</a> is used
26842689
instead of its <a>max-content contribution</a>.
2685-
For a <a>multi-line</a> container,
2690+
However, for a <a>multi-line</a> container,
26862691
it is simply the largest <a>min-content contribution</a>
26872692
of all the <a>flex items</a> in the <a>flex container</a>.
26882693

css-flexbox/Overview.html

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -303,7 +303,7 @@
303303
<div class="head">
304304
<p data-fill-with="logo"><a class="logo" href="http://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/Icons/w3c_home" width="72"> </a></p>
305305
<h1 class="p-name no-ref" id="title">CSS Flexible Box Layout Module Level 1</h1>
306-
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2015-08-30">30 August 2015</time></span></h2>
306+
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2015-08-31">31 August 2015</time></span></h2>
307307
<div data-fill-with="spec-metadata">
308308
<dl>
309309
<dt>This version:
@@ -2398,8 +2398,12 @@ <h3 class="heading settled" data-level="9.8" id="definite-sizes"><span class="se
23982398
and the <a data-link-type="dfn" href="#flex-item">flex item</a> has acquired its final size).
23992399
</ol>
24002400
<h3 class="heading settled" data-level="9.9" id="intrinsic-sizes"><span class="secno">9.9. </span><span class="content"> Intrinsic Sizes</span><a class="self-link" href="#intrinsic-sizes"></a></h3>
2401+
<p>The <a data-link-type="dfn" href="https://drafts.csswg.org/css-sizing-3/#intrinsic-sizing">intrinsic sizing</a> of a <a data-link-type="dfn" href="#flex-container">flex container</a> is used
2402+
to produce various types of content-based automatic sizing,
2403+
such as shrink-to-fit logical widths (which use the <span class="css">fit-content</span> formula)
2404+
and content-based logical heights (which use the <a data-link-type="dfn" href="#max-content-main-size">max-content main size</a>).</p>
24012405
<p>The <dfn data-dfn-type="dfn" data-noexport="" id="max-content-main-size">max-content main size<a class="self-link" href="#max-content-main-size"></a></dfn> of a <a data-link-type="dfn" href="#flex-container">flex container</a> is the smallest size the <a data-link-type="dfn" href="#flex-container">flex container</a> can take
2402-
while maintaining the <a data-link-type="dfn" href="https://drafts.csswg.org/css-sizing-3/#max_content-contribution">max-content contributions</a> of its <a data-link-type="dfn" href="#flex-item">flex items</a>.</p>
2406+
while maintaining the <a data-link-type="dfn" href="https://drafts.csswg.org/css-sizing-3/#max_content-contribution">max-content contributions</a> of its <a data-link-type="dfn" href="#flex-item">flex items</a>:</p>
24032407
<ol>
24042408
<li> For each <a data-link-type="dfn" href="#flex-item">flex item</a>,
24052409
subtract its outer <a data-link-type="dfn" href="#flex-base-size">flex base size</a> from its <a data-link-type="dfn" href="https://drafts.csswg.org/css-sizing-3/#max_content-contribution">max-content contribution</a> size.
@@ -2419,7 +2423,7 @@ <h3 class="heading settled" data-level="9.9" id="intrinsic-sizes"><span class="s
24192423
is calculated identically to the <a data-link-type="dfn" href="#max-content-main-size">max-content main size</a>,
24202424
except that the <a data-link-type="dfn" href="#flex-item">flex item’s</a><a data-link-type="dfn" href="https://drafts.csswg.org/css-sizing-3/#min_content-contribution">min-content contribution</a> is used
24212425
instead of its <a data-link-type="dfn" href="https://drafts.csswg.org/css-sizing-3/#max_content-contribution">max-content contribution</a>.
2422-
For a <a data-link-type="dfn" href="#multi-line">multi-line</a> container,
2426+
However, for a <a data-link-type="dfn" href="#multi-line">multi-line</a> container,
24232427
it is simply the largest <a data-link-type="dfn" href="https://drafts.csswg.org/css-sizing-3/#min_content-contribution">min-content contribution</a> of all the <a data-link-type="dfn" href="#flex-item">flex items</a> in the <a data-link-type="dfn" href="#flex-container">flex container</a>.</p>
24242428
<p>The <dfn data-dfn-type="dfn" data-noexport="" id="min-content-cross-size">min-content cross size<a class="self-link" href="#min-content-cross-size"></a></dfn> and <dfn data-dfn-type="dfn" data-noexport="" id="max-content-cross-size">max-content cross size<a class="self-link" href="#max-content-cross-size"></a></dfn> of a flex container
24252429
are the <a data-link-type="dfn" href="#cross-size">cross size</a> of the flex container
@@ -3893,6 +3897,7 @@ <h3 class="no-num heading settled" id="index-defined-elsewhere"><span class="con
38933897
<ul>
38943898
<li><a href="https://drafts.csswg.org/css-sizing-3/#available">available space</a>
38953899
<li><a href="https://drafts.csswg.org/css-sizing-3/#valdef-width-fit-content">fit-content</a>
3900+
<li><a href="https://drafts.csswg.org/css-sizing-3/#intrinsic-sizing">intrinsic sizing</a>
38963901
<li><a href="https://drafts.csswg.org/css-sizing-3/#valdef-width-max-content">max-content</a>
38973902
<li><a href="https://drafts.csswg.org/css-sizing-3/#max_content-constraint">max-content constraint</a>
38983903
<li><a href="https://drafts.csswg.org/css-sizing-3/#max_content-contribution">max-content contribution</a>

0 commit comments

Comments
 (0)