Skip to content

Commit c903d5c

Browse files
committed
[css-flexbox] Fix editorial nits from astearns. <https://lists.w3.org/Archives/Public/www-style/2014Oct/0267.html>
1 parent 732d20f commit c903d5c

2 files changed

Lines changed: 45 additions & 38 deletions

File tree

css-flexbox/Overview.bs

Lines changed: 34 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -626,7 +626,7 @@ Flex Items</h2>
626626

627627
<p class="note">
628628
Authors reading this spec may want to
629-
<a href="#item-margins">skip past the following box-generation details</a>.
629+
<a href="#item-margins">skip past the following box-generation and static position details</a>.
630630

631631
The 'display' value of a <a>flex item</a> is <a>blockified</a>:
632632
if the specified 'display' of an in-flow child of an element generating a <a>flex container</a>
@@ -679,8 +679,6 @@ Absolutely-Positioned Flex Children</h3>
679679
assuming both the child and the flex container
680680
were fixed-size boxes of their used size.
681681

682-
<hr>
683-
684682
In other words,
685683
the <a>static position</a> of an absolutely positioned child of a <a>flex container</a>
686684
is determined <em>after flex layout</em>
@@ -934,20 +932,24 @@ Implied Minimum Size of Flex Items</h3>
934932
<dl>
935933
<dt><var>clamped size</var>
936934
<dd>
937-
is defined if the item’s computed 'flex-basis' is ''auto''
935+
If the item’s computed 'flex-basis' is ''auto''
938936
and its computed <a>main size property</a> is <a>definite</a>,
939-
and is that size (clamped by its <a>max main size property</a> if it's <a>definite</a>).
937+
then the <a>clamped size</a> is that size
938+
(clamped by its <a>max main size property</a> if it's <a>definite</a>).
939+
It is otherwise undefined.
940940

941941
<dt><var>transferred size</var>
942942
<dd>
943-
is defined if the item has an intrinsic aspect ratio
943+
If the item has an intrinsic aspect ratio
944944
and its computed <a>cross size property</a> is <a>definite</a>,
945-
and is that size (clamped by its <a lt="min cross size property">min and max cross size properties</a> if they are <a>definite</a>),
945+
then the <a>transferred size</a> is that size
946+
(clamped by its <a lt="min cross size property">min and max cross size properties</a> if they are <a>definite</a>),
946947
converted through the aspect ratio.
948+
It is otherwise undefined.
947949

948950
<dt><var>content size</var>
949951
<dd>
950-
is the <a>min-content size</a> in the <a>main axis</a>,
952+
The <a>content size</a> is the <a>min-content size</a> in the <a>main axis</a>,
951953
clamped, if it has an aspect ratio, by any <a>definite</a> <a lt="min cross size property">min and max cross size properties</a> converted through the aspect ratio,
952954
and then further clamped by the <a>max main size property</a> if that is <a>definite</a>.
953955
</dl>
@@ -1919,7 +1921,7 @@ Axis Alignment: the 'justify-content' property</h3>
19191921
<a>Flex items</a> are packed toward the center of the line.
19201922
The <a>flex items</a> on the line are placed flush with each other
19211923
and aligned in the center of the line,
1922-
with equal amounts of empty space between the <a>main-start</a> edge of the line and the first item on the line
1924+
with equal amounts of space between the <a>main-start</a> edge of the line and the first item on the line
19231925
and between the <a>main-end</a> edge of the line and the last item on the line.
19241926
(If the leftover free-space is negative,
19251927
the <a>flex items</a> will overflow equally in both directions.)
@@ -2111,7 +2113,7 @@ Packing Flex Lines: the 'align-content' property</h3>
21112113
Lines are packed toward the center of the flex container.
21122114
The lines in the flex container are placed flush with each other
21132115
and aligned in the center of the flex container,
2114-
with equal amounts of empty space
2116+
with equal amounts of space
21152117
between the <a>cross-start</a> content edge of the flex container
21162118
and the first line in the flex container,
21172119
and between the <a>cross-end</a> content edge of the flex container
@@ -2336,7 +2338,7 @@ Line Length Determination</h3>
23362338
and the flex container is being sized under a min-content or max-content constraint
23372339
(e.g. when performing <a href="http://www.w3.org/TR/CSS21/tables.html#auto-table-layout">automatic table layout</a> [[!CSS21]]),
23382340
size the item under that constraint.
2339-
The <a>flex base size</a> is the item's resulting main size.
2341+
The <a>flex base size</a> is the item's resulting <a>main size</a>.
23402342

23412343
<li>
23422344
Otherwise,
@@ -2345,7 +2347,7 @@ Line Length Determination</h3>
23452347
and the flex item's inline axis is parallel to the main axis,
23462348
lay the item out using
23472349
<a href="http://www.w3.org/TR/css3-writing-modes/#orthogonal-flows">the rules for a box in an orthogonal flow</a> [[!CSS3-WRITING-MODES]].
2348-
The <a>flex base size</a> is the item's max-content main size.
2350+
The <a>flex base size</a> is the item's max-content <a>main size</a>.
23492351

23502352
<li>
23512353
Otherwise,
@@ -2364,7 +2366,7 @@ Line Length Determination</h3>
23642366
clamped according to its min and max main size properties.
23652367

23662368
<li id='algo-main-container'>
2367-
<strong>Determine the main size of the flex container</strong>
2369+
<strong>Determine the <a>main size</a> of the flex container</strong>
23682370
using the rules of the formatting context in which it participates.
23692371
For this computation, <a value for=margin>auto</a> margins on flex items are treated as ''0''.
23702372
</ol>
@@ -2407,7 +2409,7 @@ Main Size Determination</h3>
24072409

24082410
<li id='algo-flex'>
24092411
<strong><a href='#resolve-flexible-lengths'>Resolve the flexible lengths</a></strong> of all the flex items
2410-
to find their used main size (see section 9.7.).
2412+
to find their used <a>main size</a> (see section 9.7.).
24112413
</ol>
24122414

24132415
<h3 id='cross-sizing'>
@@ -2416,7 +2418,7 @@ Cross Size Determination</h3>
24162418
<ol class=continue>
24172419
<li id='algo-cross-item'>
24182420
<strong>Determine the <dfn>hypothetical cross size</dfn> of each item</strong>
2419-
by performing layout with the used main size and the available space,
2421+
by performing layout with the used <a>main size</a> and the available space,
24202422
treating <a value for=width>auto</a> as ''fit-content''.
24212423

24222424
<li id='algo-cross-line'>
@@ -2472,7 +2474,7 @@ Cross Size Determination</h3>
24722474
<p>
24732475
In this second layout round,
24742476
when <a href="#algo-line-break">collecting items into lines</a>,
2475-
treat the collapsed items as having zero main size.
2477+
treat the collapsed items as having zero <a>main size</a>.
24762478
For the rest of the algorithm following that step,
24772479
ignore the collapsed items entirely
24782480
(as if they were ''display:none'')
@@ -2501,7 +2503,7 @@ Cross Size Determination</h3>
25012503
so that percentage-sized children can be resolved.
25022504

25032505
<p class='note'>
2504-
Note that this step does not affect the main size of the flex item,
2506+
Note that this step does not affect the <a>main size</a> of the flex item,
25052507
even if it has an intrinsic aspect ratio.
25062508
</ol>
25072509

@@ -2582,7 +2584,7 @@ Resolving Flexible Lengths</h3>
25822584
<li>
25832585
<strong>Determine the used flex factor</strong>.
25842586
Sum the outer hypothetical main sizes of all items on the line.
2585-
If the sum is less than the flex container's inner main size,
2587+
If the sum is less than the flex container's inner <a>main size</a>,
25862588
use the flex grow factor for the rest of this algorithm;
25872589
otherwise, use the flex shrink factor.
25882590

@@ -2607,7 +2609,7 @@ Resolving Flexible Lengths</h3>
26072609
<li>
26082610
<strong>Calculate <dfn>initial free space</dfn>.</strong>
26092611
Sum the outer sizes of all items on the line,
2610-
and subtract this from the flex container's inner main size.
2612+
and subtract this from the flex container's inner <a>main size</a>.
26112613
For frozen items, use their outer <a>target main size</a>;
26122614
for other items, use their outer <a>flex base size</a>.
26132615

@@ -2647,13 +2649,13 @@ Resolving Flexible Lengths</h3>
26472649
<dt>If using the <a>flex shrink factor</a>
26482650
<dd>
26492651
For every unfrozen item on the line,
2650-
multiply its flex shrink factor by its inner flex base size,
2652+
multiply its flex shrink factor by its inner <a>flex base size</a>,
26512653
and note this as its <dfn>scaled flex shrink factor</dfn>.
26522654
Find the ratio of the item's <a>scaled flex shrink factor</a>
26532655
to the sum of the <a>scaled flex shrink factors</a> of all unfrozen items on the line.
26542656
Set the item's <a>target main size</a> to its <a>flex base size</a>
26552657
minus a fraction of the absolute value of the <a>remaining free space</a> proportional to the ratio.
2656-
<span class='note'>Note this may result in a negative inner main size;
2658+
<span class='note'>Note this may result in a negative inner <a>main size</a>;
26572659
it will be corrected in the next step.</span>
26582660

26592661
<dt>Otherwise
@@ -2721,9 +2723,9 @@ Definite and Indefinite Sizes</h3>
27212723

27222724
<ol>
27232725
<li>
2724-
If a <a>single-line</a> <a>flex container</a> has a definite cross size,
2726+
If a <a>single-line</a> <a>flex container</a> has a definite <a>cross size</a>,
27252727
the outer <a>cross size</a> of any <a>stretched</a> <a>flex items</a>
2726-
is the flex container's inner cross size (clamped to the <a>flex item</a>’s min and max <a>cross size</a>)
2728+
is the flex container's inner <a>cross size</a> (clamped to the <a>flex item</a>’s min and max <a>cross size</a>)
27272729
and is considered <a>definite</a>.
27282730

27292731
<li>
@@ -2788,7 +2790,7 @@ Intrinsic Sizes</h3>
27882790
of all the <a>flex items</a> in the <a>flex container</a>.
27892791

27902792
The <dfn>min-content cross size</dfn> and <dfn>max-content cross size</dfn> of a flex container
2791-
are the cross size of the flex container
2793+
are the <a>cross size</a> of the flex container
27922794
after performing layout into the given available <a>main-axis</a> space and infinite available <a>cross-axis</a> space.
27932795

27942796
The main-size <a lt="min-content contribution">min-content</a>/<a>max-content contribution</a> of a <a>flex item</a>
@@ -3059,7 +3061,7 @@ Sample Flex Fragmentation Algorithm</h3>
30593061
<li>
30603062
If any item,
30613063
when aligned according to its original 'align-self' value
3062-
into the combined cross size of all the flex container fragments,
3064+
into the combined <a>cross size</a> of all the flex container fragments,
30633065
would fit entirely within a single flex container fragment,
30643066
it may be shifted into that fragment
30653067
and aligned appropriately.
@@ -3281,7 +3283,7 @@ Substantive Changes and Bugfixes</h4>
32813283
</blockquote>
32823284

32833285
<li id="change-201403-clamp-single-line">
3284-
Clamp a single line flexbox's line cross size to the container's own min/max,
3286+
Clamp a single line flexbox's line <a>cross size</a> to the container's own min/max,
32853287
even when the container's size is indefinite.
32863288
(Issue <a href="http://dev.w3.org/csswg/css-flexbox-1/issues-lc-20140325#issue-9">9</a>)
32873289

@@ -3380,7 +3382,7 @@ Clarifications</h4>
33803382
for the purposes of special behavior (like definiteness).
33813383
(Issue <a href="http://dev.w3.org/csswg/css-flexbox-1/issues-lc-20140325#issue-25">25</a>)
33823384
<blockquote>
3383-
<p>If the cross size property of the flex item computes to auto,
3385+
<p>If the <a>cross size</a> property of the flex item computes to auto,
33843386
<ins>and either of the cross-axis margins are auto, the flex item is stretched. Its</ins>
33853387
<del>its</del> used value &hellip;
33863388
</blockquote>
@@ -3459,9 +3461,9 @@ Substantive Changes and Bugfixes</h4>
34593461
<ins>
34603462
<p>
34613463
As a special case for handling stretched <a>flex items</a>,
3462-
if a <a>single-line</a> <a>flex container</a> has a definite cross size,
3464+
if a <a>single-line</a> <a>flex container</a> has a definite <a>cross size</a>,
34633465
the outer <a>cross size</a> of any <a>flex items</a> with ''align-self: stretch''
3464-
is the flex container's inner cross size
3466+
is the flex container's inner <a>cross size</a>
34653467
(clamped to the <a>flex item</a>’s min and max <a>cross size</a>)
34663468
and is considered <a>definite</a>.</p>
34673469
</ins>
@@ -3472,7 +3474,7 @@ Substantive Changes and Bugfixes</h4>
34723474
<blockquote>
34733475
<ins>
34743476
<p>If the flex item has ''align-self: stretch'', redo layout for its contents,
3475-
treating this used size as its definite cross size
3477+
treating this used size as its definite <a>cross size</a>
34763478
so that percentage-sized children can be resolved.
34773479

34783480
<p class="note">Note that this step does not affect the main size of the flex item,
@@ -3500,7 +3502,7 @@ Substantive Changes and Bugfixes</h4>
35003502
<blockquote>
35013503
<p><ins>If a <a>cross size</a> is needed to determine the <a>main size</a>
35023504
(e.g. when the <a>flex item</a>’s <a>main size</a> is in its block axis)
3503-
and the <a>flex item</a>’s cross size is ''auto'' and not <a>definite</a>,
3505+
and the <a>flex item</a>’s <a>cross size</a> is ''auto'' and not <a>definite</a>,
35043506
in this calculation use ''height/fit-content'' as the <a>flex item</a>’s <a>cross size</a>.</ins>
35053507
</blockquote>
35063508
<li id="change-2012-intrinsic-sizes">
@@ -3533,7 +3535,7 @@ Substantive Changes and Bugfixes</h4>
35333535

35343536
<p>
35353537
The <a>min-content cross size</a> and <a>max-content cross size</a> of a flex container
3536-
are the cross size of the flex container
3538+
are the <a>cross size</a> of the flex container
35373539
after performing layout into the given available <a>main-axis</a> space
35383540
and infinite available <a>cross-axis</a> space.
35393541

css-flexbox/issues-lc-20140925.txt

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@ Issue 1.
66
Summary: Use preferred size instead of max-content size
77
From: Tab Atkins
88
Comment: https://lists.w3.org/Archives/Public/www-style/2014Aug/0385.html
9-
Open
9+
Response: https://lists.w3.org/Archives/Public/www-style/2015Feb/0424.html
10+
Closed: OutOfScope
1011
----
1112
Issue 2.
1213
Summary: Flex item handling of anonymous boxes should be normative
@@ -49,7 +50,9 @@ Issue 7.
4950
Summary: Alias no-wrap to nowrap
5051
From: Tab Atkins
5152
Comment: https://lists.w3.org/Archives/Public/www-style/2014Oct/0188.html
52-
Open
53+
Response: https://lists.w3.org/Archives/Public/www-style/2015Jan/0581.html
54+
Closed: Rejected
55+
Resolved: https://lists.w3.org/Archives/Public/www-style/2015Jan/0581.html
5356
----
5457
Issue 8.
5558
Summary: Error in flex container max-content definition
@@ -74,14 +77,14 @@ Comment: https://lists.w3.org/Archives/Public/www-style/2014Nov/0023.html
7477
Response: https://lists.w3.org/Archives/Public/www-style/2015Jan/0342.html
7578
Closed: Accepted
7679
Resolved: https://lists.w3.org/Archives/Public/www-style/2014Nov/0401.html
77-
Open: https://lists.w3.org/Archives/Public/www-style/2015Jan/0346.html
80+
Followup: https://lists.w3.org/Archives/Public/www-style/2015Jan/0346.html
7881
----
7982
Issue 11.
8083
Summary: Clarify that flex layout is writing-mode relative
8184
From: Addison Phillips
8285
Comment: https://lists.w3.org/Archives/Public/www-style/2014Nov/0058.html
8386
Response: https://lists.w3.org/Archives/Public/www-style/2015Jan/0344.html
84-
Open: Waiting for verification.
87+
Closed: Accepted
8588
----
8689
Issue 12.
8790
Summary: Example should state general case, put specific in parens, not vice versa
@@ -124,9 +127,11 @@ Summary: Forced flex line breaking controls
124127
From: Glen Huang
125128
Comment: https://lists.w3.org/Archives/Public/www-style/2015Jan/0322.html
126129
Response: https://lists.w3.org/Archives/Public/www-style/2015Jan/0336.html
127-
Open: Agenda+
130+
Closed: Deferred
128131
----
129132
Issue 18.
130133
Summary: Spec conflicts with itself on interpretation of break controls
131134
Comment: https://lists.w3.org/Archives/Public/www-style/2015Jan/0349.html
132-
Open
135+
Response: https://lists.w3.org/Archives/Public/www-style/2015Feb/0263.html
136+
Closed: Accepted
137+
----

0 commit comments

Comments
 (0)