Skip to content

Commit 1b0c47b

Browse files
committed
[css-flexbox] Clarify that flex-basis is a width/height thing not just a width thing.
1 parent 9662739 commit 1b0c47b

2 files changed

Lines changed: 18 additions & 19 deletions

File tree

css-flexbox/Overview.bs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1486,7 +1486,7 @@ The 'flex-basis' property</h4>
14861486

14871487
<p>
14881488
The 'flex-basis' property sets the <i>flex basis</i>.
1489-
Negative lengths are invalid.
1489+
It accepts the same values as the 'width' and 'height' property.
14901490

14911491
<p>
14921492
Except for <dfn value for=flex-basis>auto</dfn>,
@@ -2390,7 +2390,7 @@ Free Space Focused Algorithm (LC version)</h4>
23902390
Otherwise, use each item’s <i>desired free space</i> as its <i>normalized free space</i>.
23912391

23922392
<li>
2393-
<strong>Calculate each item’s <dfn>target main size</dfn>.</strong>
2393+
<strong>Calculate each item’s <i>target main size</i>.</strong>
23942394
Set each non-frozen flex item's <i>target main size</i>
23952395
to the sum of its <a>flex base size</a> and its <var>normalized free space</var>.
23962396
Note: This may result in a negative main size temporarily.

css-flexbox/Overview.html

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1559,7 +1559,7 @@ <h4 class="heading settled heading" data-level=7.3.3 id=flex-basis-property><spa
15591559

15601560
<p>
15611561
The <a class=property data-link-type=propdesc href=#propdef-flex-basis title=flex-basis>flex-basis</a> property sets the <a data-link-type=dfn href=#flex-basis title="flex basis">flex basis</a>.
1562-
Negative lengths are invalid.
1562+
It accepts the same values as the <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visudet.html#propdef-width title=width>width</a> and <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visudet.html#propdef-height title=height>height</a> property.
15631563

15641564
<p>
15651565
Except for <dfn class=css-code data-dfn-for=flex-basis data-dfn-type=value data-export="" id=valuedef-auto1>auto<a class=self-link href=#valuedef-auto1></a></dfn>,
@@ -2360,7 +2360,7 @@ <h4 class="heading settled heading" data-level=9.7.1 id=resolve-flexible-lengths
23602360
<li>
23612361
<strong>Size inflexible items.</strong>
23622362
Freeze,
2363-
setting its <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a>
2363+
setting its <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a>
23642364
to its <a data-link-type=dfn href=#hypothetical-main-size title="hypothetical main size">hypothetical main size</a>
23652365
<ul>
23662366
<li>
@@ -2379,7 +2379,7 @@ <h4 class="heading settled heading" data-level=9.7.1 id=resolve-flexible-lengths
23792379
<strong>Calculate initial <dfn data-dfn-type=dfn data-noexport="" id=free-space>free space<a class=self-link href=#free-space></a></dfn>.</strong>
23802380
Sum the outer sizes of all items on the line,
23812381
and subtract this from the flex container’s inner main size.
2382-
For frozen items, use their outer <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a>;
2382+
For frozen items, use their outer <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a>;
23832383
for other items, use their outer <a data-link-type=dfn href=#flex-base-size title="flex base size">flex base size</a>.
23842384

23852385
<li>
@@ -2421,14 +2421,14 @@ <h4 class="heading settled heading" data-level=9.7.1 id=resolve-flexible-lengths
24212421
Otherwise, use each item’s <a data-link-type=dfn href=#desired-free-space title="desired free space">desired free space</a> as its <a data-link-type=dfn href=#normalized-free-space title="normalized free space">normalized free space</a>.
24222422

24232423
<li>
2424-
<strong>Calculate each item’s <dfn data-dfn-type=dfn data-noexport="" id=target-main-size0>target main size<a class=self-link href=#target-main-size0></a></dfn>.</strong>
2425-
Set each non-frozen flex item’s <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a>
2424+
<strong>Calculate each item’s <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a>.</strong>
2425+
Set each non-frozen flex item’s <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a>
24262426
to the sum of its <a data-link-type=dfn href=#flex-base-size title="flex base size">flex base size</a> and its <var>normalized free space</var>.
24272427
Note: This may result in a negative main size temporarily.
24282428

24292429
<li>
24302430
<strong>Fix min/max violations.</strong>
2431-
Clamp each non-frozen item’s <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a> by its min and max main size properties.
2431+
Clamp each non-frozen item’s <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a> by its min and max main size properties.
24322432
If the item’s main size was made smaller by this, it’s a max violation.
24332433
If the item’s main size was made larger by this, it’s a min violation.
24342434

@@ -2456,7 +2456,7 @@ <h4 class="heading settled heading" data-level=9.7.1 id=resolve-flexible-lengths
24562456
Return to the first step, “Distribute free space.”
24572457
</ol>
24582458
<li>
2459-
<strong>Set each item’s used main size to its <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a>.</strong>
2459+
<strong>Set each item’s used main size to its <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a>.</strong>
24602460
Note: All items should be frozen at this point.
24612461
</ol>
24622462

@@ -2496,7 +2496,7 @@ <h4 class="heading settled heading" data-level=9.7.2 id=resolve-flexible-lengths
24962496
<strong>Calculate <dfn data-dfn-type=dfn data-noexport="" id=initial-free-space>initial free space<a class=self-link href=#initial-free-space></a></dfn>.</strong>
24972497
Sum the outer sizes of all items on the line,
24982498
and subtract this from the flex container’s inner main size.
2499-
For frozen items, use their outer <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a>;
2499+
For frozen items, use their outer <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a>;
25002500
for other items, use their outer <a data-link-type=dfn href=#flex-base-size title="flex base size">flex base size</a>.
25012501

25022502
<li>
@@ -2525,7 +2525,7 @@ <h4 class="heading settled heading" data-level=9.7.2 id=resolve-flexible-lengths
25252525
<dd>
25262526
Find the ratio of the item’s flex grow factor
25272527
to the sum of the flex grow factors of all unfrozen items on the line.
2528-
Set the item’s <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a> to its <a data-link-type=dfn href=#flex-base-size title="flex base size">flex base size</a>
2528+
Set the item’s <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a> to its <a data-link-type=dfn href=#flex-base-size title="flex base size">flex base size</a>
25292529
plus a fraction of the <a data-link-type=dfn href=#remaining-free-space title="remaining free space">remaining free space</a> proportional to the ratio.
25302530

25312531
<dt>If using the <a data-link-type=dfn href=#flex-shrink-factor title="flex shrink factor">flex shrink factor</a> the <a data-link-type=dfn href=#remaining-free-space title="remaining free space">remaining free space</a> is negative
@@ -2535,7 +2535,7 @@ <h4 class="heading settled heading" data-level=9.7.2 id=resolve-flexible-lengths
25352535
and note this as its <dfn data-dfn-type=dfn data-noexport="" id=scaled-flex-shrink-factor>scaled flex shrink factor<a class=self-link href=#scaled-flex-shrink-factor></a></dfn>.
25362536
Find the ratio of the item’s <a data-link-type=dfn href=#scaled-flex-shrink-factor title="scaled flex shrink factor">scaled flex shrink factor</a>
25372537
to the sum of the <a data-link-type=dfn href=#scaled-flex-shrink-factor title="scaled flex shrink factors">scaled flex shrink factors</a> of all unfrozen items on the line.
2538-
Set the item’s <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a> to its <a data-link-type=dfn href=#flex-base-size title="flex base size">flex base size</a>
2538+
Set the item’s <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a> to its <a data-link-type=dfn href=#flex-base-size title="flex base size">flex base size</a>
25392539
minus a fraction of the absolute value of the <a data-link-type=dfn href=#remaining-free-space title="remaining free space">remaining free space</a> proportional to the ratio.
25402540
<span class=note>Note this may result in a negative inner main size;
25412541
it will be corrected in the next step.</span>
@@ -2547,10 +2547,10 @@ <h4 class="heading settled heading" data-level=9.7.2 id=resolve-flexible-lengths
25472547

25482548
<li>
25492549
<strong>Fix min/max violations.</strong>
2550-
Clamp each non-frozen item’s <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a> by its min and max main size properties.
2551-
If the item’s <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a> was made smaller by this,
2550+
Clamp each non-frozen item’s <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a> by its min and max main size properties.
2551+
If the item’s <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a> was made smaller by this,
25522552
it’s a max violation.
2553-
If the item’s <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a> was made larger by this,
2553+
If the item’s <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a> was made larger by this,
25542554
it’s a min violation.
25552555

25562556
<li>
@@ -2578,7 +2578,7 @@ <h4 class="heading settled heading" data-level=9.7.2 id=resolve-flexible-lengths
25782578
</ol>
25792579

25802580
<li>
2581-
Set each item’s used <a data-link-type=dfn href=#main-size title="main size">main size</a> to its <a data-link-type=dfn href=#target-main-size0 title="target main size">target main size</a>.
2581+
Set each item’s used <a data-link-type=dfn href=#main-size title="main size">main size</a> to its <a data-link-type=dfn href=#target-main-size title="target main size">target main size</a>.
25822582
</ol>
25832583

25842584

@@ -3633,9 +3633,8 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
36333633
<li>stretch<ul><li>value for align-items, align-self, <a href=#valuedef-stretch0 title="section 8.3">8.3</a>
36343634
<li>value for align-content, <a href=#valuedef-stretch title="section 8.4">8.4</a>
36353635
</ul><li>strut size, <a href=#strut-size title="section 9.4">9.4</a>
3636-
<li>target main size<ul><li>definition of, <a href=#target-main-size0 title="section 9.7.1">9.7.1</a>
3637-
<li>definition of, <a href=#target-main-size title="section 9.7.2">9.7.2</a>
3638-
</ul><li>wrap, <a href=#valuedef-wrap title="section 5.2">5.2</a>
3636+
<li>target main size, <a href=#target-main-size title="section 9.7.2">9.7.2</a>
3637+
<li>wrap, <a href=#valuedef-wrap title="section 5.2">5.2</a>
36393638
<li>wrap-reverse, <a href=#valuedef-wrap-reverse title="section 5.2">5.2</a>
36403639
</ul></div>
36413640

0 commit comments

Comments
 (0)