Skip to content

Commit 4642c9a

Browse files
committed
[css-flexbox] Minor editrial adjustments to flex shorthand definition.
1 parent c903d5c commit 4642c9a

File tree

3 files changed

+48
-38
lines changed

3 files changed

+48
-38
lines changed

css-flexbox/Overview.bs

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -934,22 +934,22 @@ Implied Minimum Size of Flex Items</h3>
934934
<dd>
935935
If the item’s computed 'flex-basis' is ''auto''
936936
and its computed <a>main size property</a> is <a>definite</a>,
937-
then the <a>clamped size</a> is that size
937+
then the <var>clamped size</var> is that size
938938
(clamped by its <a>max main size property</a> if it's <a>definite</a>).
939939
It is otherwise undefined.
940940

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

950950
<dt><var>content size</var>
951951
<dd>
952-
The <a>content size</a> is the <a>min-content size</a> in the <a>main axis</a>,
952+
The <var>content size</var> is the <a>min-content size</a> in the <a>main axis</a>,
953953
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,
954954
and then further clamped by the <a>max main size property</a> if that is <a>definite</a>.
955955
</dl>
@@ -1530,37 +1530,39 @@ The 'flex' Shorthand</h3>
15301530
<dt><dfn><<'flex-basis'>></dfn>
15311531
<dd>
15321532
<p>
1533-
This component takes the same values as the 'width' property
1534-
(except ''flex-basis/auto'' is treated differently)
1535-
and an additional ''content'' keyword.
1536-
1537-
It sets the 'flex-basis' <a href="#flex-components">longhand</a>
1533+
This component sets the 'flex-basis' <a href="#flex-components">longhand</a>
15381534
and specifies the <dfn dfn>flex basis</dfn>:
15391535
the initial <a>main size</a> of the <a>flex item</a>,
15401536
before free space is distributed according to the flex factors.
1537+
It takes the same values as the 'width' property
1538+
(except ''flex-basis/auto'' is treated differently)
1539+
and an additional ''content'' keyword.
15411540
When omitted from the 'flex' shorthand, its specified value is ''0%''.
15421541

15431542
If the specified 'flex-basis' is ''flex-basis/auto'',
15441543
the used <a>flex basis</a> is the computed value of the flex item’s <a>main size property</a>.
15451544
If that value is itself ''width/auto'',
15461545
then the used <a>flex basis</a> is automatically-determined based on its content (i.e. ''content'').
15471546

1548-
<figure>
1549-
<img src='images/rel-vs-abs-flex.svg' width='504' height='240'>
1550-
<figcaption>
1551-
A diagram showing the difference between "absolute" flex
1552-
(starting from a basis of zero)
1553-
and "relative" flex
1554-
(starting from a basis of the item's content size).
1555-
The three items have flex factors of ''1'', ''1'', and ''2'', respectively.
1556-
</figcaption>
1557-
</figure>
1558-
15591547
<dt><dfn>none</dfn>
15601548
<dd>
15611549
<p>The keyword ''none'' expands to ''0 0 auto''.
15621550
</dl>
15631551

1552+
1553+
<figure>
1554+
<img src='images/rel-vs-abs-flex.svg' width='504' height='240'>
1555+
<figcaption>
1556+
A diagram showing the difference between "absolute" flex
1557+
(starting from a basis of zero)
1558+
and "relative" flex
1559+
(starting from a basis of the item's content size).
1560+
The three items have flex factors of ''1'', ''1'', and ''2'', respectively:
1561+
notice that the item with a flex factor of ''2'' grows twice as fast as the others.
1562+
</figcaption>
1563+
</figure>
1564+
1565+
15641566
<p>
15651567
The initial values of the 'flex' components are equivalent to <a class="css-code" href="#flex-initial">flex: 0 1 auto</a>.
15661568
<p class="note">

css-flexbox/issues-lc-20140925.html

Lines changed: 23 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -31,12 +31,13 @@ <h1>CSS Flexible Box Layout Level 1 Disposition of Comments for 2014-09-25 LCWD<
3131
<p>An issue can be closed as <code>Accepted</code>, <code>OutOfScope</code>,
3232
<code>Invalid</code>, <code>Rejected</code>, or <code>Retracted</code>.
3333
<code>Verified</code> indicates commentor's acceptance of the response.</p>
34-
<pre class='open' id='issue-1'>
34+
<pre class='oi' id='issue-1'>
3535
Issue 1. <a href='#issue-1'>#</a>
3636
Summary: Use preferred size instead of max-content size
3737
From: Tab Atkins
3838
Comment: <a href='https://lists.w3.org/Archives/Public/www-style/2014Aug/0385.html'>https://lists.w3.org/Archives/Public/www-style/2014Aug/0385.html</a>
39-
Open
39+
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Feb/0424.html'>https://lists.w3.org/Archives/Public/www-style/2015Feb/0424.html</a>
40+
Closed: OutOfScope
4041
</pre>
4142
<pre class='a' id='issue-2'>
4243
Issue 2. <a href='#issue-2'>#</a>
@@ -48,11 +49,13 @@ <h1>CSS Flexible Box Layout Level 1 Disposition of Comments for 2014-09-25 LCWD<
4849
Verified: <a href='http://lists.w3.org/Archives/Public/www-style/2014Oct/0269.html'>http://lists.w3.org/Archives/Public/www-style/2014Oct/0269.html</a>
4950
Resolved: Bugfix
5051
</pre>
51-
<pre class='' id='issue-3'>
52+
<pre class='a' id='issue-3'>
5253
Issue 3. <a href='#issue-3'>#</a>
5354
Summary: Editorial nits
5455
From: Alan Stearns
5556
Comment: <a href='http://lists.w3.org/Archives/Public/www-style/2014Oct/0267.html'>http://lists.w3.org/Archives/Public/www-style/2014Oct/0267.html</a>
57+
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Feb/0431.html'>https://lists.w3.org/Archives/Public/www-style/2015Feb/0431.html</a>
58+
Closed: Accepted
5659
</pre>
5760
<pre class='a' id='issue-4'>
5861
Issue 4. <a href='#issue-4'>#</a>
@@ -63,13 +66,13 @@ <h1>CSS Flexible Box Layout Level 1 Disposition of Comments for 2014-09-25 LCWD<
6366
Closed: Accepted
6467
Resolved: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0004.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0004.html</a>
6568
</pre>
66-
<pre class='open' id='issue-5'>
69+
<pre class='oi' id='issue-5'>
6770
Issue 5. <a href='#issue-5'>#</a>
6871
Summary: Clarify sizing of abspos flex containers
6972
From: François Remy
7073
Comment: <a href='https://lists.w3.org/Archives/Public/www-style/2014Sep/0396.html'>https://lists.w3.org/Archives/Public/www-style/2014Sep/0396.html</a>
71-
Response:
72-
Open
74+
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Feb/0191.html'>https://lists.w3.org/Archives/Public/www-style/2015Feb/0191.html</a>
75+
Closed: Invalid
7376
</pre>
7477
<pre class='a' id='issue-6'>
7578
Issue 6. <a href='#issue-6'>#</a>
@@ -80,12 +83,14 @@ <h1>CSS Flexible Box Layout Level 1 Disposition of Comments for 2014-09-25 LCWD<
8083
Closed: Accepted
8184
Resolved: Bugfix
8285
</pre>
83-
<pre class='open' id='issue-7'>
86+
<pre class='r' id='issue-7'>
8487
Issue 7. <a href='#issue-7'>#</a>
8588
Summary: Alias no-wrap to nowrap
8689
From: Tab Atkins
8790
Comment: <a href='https://lists.w3.org/Archives/Public/www-style/2014Oct/0188.html'>https://lists.w3.org/Archives/Public/www-style/2014Oct/0188.html</a>
88-
Open
91+
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0581.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0581.html</a>
92+
Closed: Rejected
93+
Resolved: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0581.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0581.html</a>
8994
</pre>
9095
<pre class='a' id='issue-8'>
9196
Issue 8. <a href='#issue-8'>#</a>
@@ -105,23 +110,23 @@ <h1>CSS Flexible Box Layout Level 1 Disposition of Comments for 2014-09-25 LCWD<
105110
Closed: Accepted
106111
Resolved: Editors' discretion
107112
</pre>
108-
<pre class='a open' id='issue-10'>
113+
<pre class='a' id='issue-10'>
109114
Issue 10. <a href='#issue-10'>#</a>
110115
Summary: Revert 'flex-basis: auto' rename, add 'content' value instead
111116
From: Rossen Atanassov
112117
Comment: <a href='https://lists.w3.org/Archives/Public/www-style/2014Nov/0023.html'>https://lists.w3.org/Archives/Public/www-style/2014Nov/0023.html</a>
113118
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0342.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0342.html</a>
114119
Closed: Accepted
115120
Resolved: <a href='https://lists.w3.org/Archives/Public/www-style/2014Nov/0401.html'>https://lists.w3.org/Archives/Public/www-style/2014Nov/0401.html</a>
116-
Open: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0346.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0346.html</a>
121+
Followup: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0346.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0346.html</a>
117122
</pre>
118-
<pre class='open' id='issue-11'>
123+
<pre class='a' id='issue-11'>
119124
Issue 11. <a href='#issue-11'>#</a>
120125
Summary: Clarify that flex layout is writing-mode relative
121126
From: Addison Phillips
122127
Comment: <a href='https://lists.w3.org/Archives/Public/www-style/2014Nov/0058.html'>https://lists.w3.org/Archives/Public/www-style/2014Nov/0058.html</a>
123128
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0344.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0344.html</a>
124-
Open: Waiting for verification.
129+
Closed: Accepted
125130
</pre>
126131
<pre class='r' id='issue-12'>
127132
Issue 12. <a href='#issue-12'>#</a>
@@ -164,20 +169,21 @@ <h1>CSS Flexible Box Layout Level 1 Disposition of Comments for 2014-09-25 LCWD<
164169
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0121.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0121.html</a>
165170
Open: Rejected, but still under discussion by WG.
166171
</pre>
167-
<pre class='open' id='issue-17'>
172+
<pre class='d' id='issue-17'>
168173
Issue 17. <a href='#issue-17'>#</a>
169174
Summary: Forced flex line breaking controls
170175
From: Glen Huang
171176
Comment: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0322.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0322.html</a>
172177
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0336.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0336.html</a>
173-
Open: Agenda+
178+
Closed: Deferred
174179
</pre>
175-
<pre class='open' id='issue-18'>
180+
<pre class='a' id='issue-18'>
176181
Issue 18. <a href='#issue-18'>#</a>
177182
Summary: Spec conflicts with itself on interpretation of break controls
178183
Comment: <a href='https://lists.w3.org/Archives/Public/www-style/2015Jan/0349.html'>https://lists.w3.org/Archives/Public/www-style/2015Jan/0349.html</a>
179-
Open
180-
</pre>
184+
Response: <a href='https://lists.w3.org/Archives/Public/www-style/2015Feb/0263.html'>https://lists.w3.org/Archives/Public/www-style/2015Feb/0263.html</a>
185+
Closed: Accepted
186+
----</pre>
181187
<script>
182188
(function () {
183189
var sheet = document.styleSheets[0];

css-flexbox/issues-lc-20140925.txt

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ Issue 3.
2222
Summary: Editorial nits
2323
From: Alan Stearns
2424
Comment: http://lists.w3.org/Archives/Public/www-style/2014Oct/0267.html
25+
Response: https://lists.w3.org/Archives/Public/www-style/2015Feb/0431.html
26+
Closed: Accepted
2527
----
2628
Issue 4.
2729
Summary: Alignment shouldn't depend on number of lines, but on wrappability
@@ -35,8 +37,8 @@ Issue 5.
3537
Summary: Clarify sizing of abspos flex containers
3638
From: François Remy
3739
Comment: https://lists.w3.org/Archives/Public/www-style/2014Sep/0396.html
38-
Response:
39-
Open
40+
Response: https://lists.w3.org/Archives/Public/www-style/2015Feb/0191.html
41+
Closed: Invalid
4042
----
4143
Issue 6.
4244
Summary: Error in stretch definition

0 commit comments

Comments
 (0)