Skip to content

Commit 0343ba1

Browse files
committed
Let's actually regen the right spec, hm?
1 parent 7d9b74f commit 0343ba1

2 files changed

Lines changed: 73 additions & 48 deletions

File tree

css-variables/Overview.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,15 +21,15 @@
2121

2222
<h1>CSS Variables Module Level 1</h1>
2323

24-
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 9 May 2012</h2>
24+
<h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 10 May 2012</h2>
2525

2626
<dl>
2727
<dt>This version:
28-
<!--<dd><a href="http://www.w3.org/TR/2012/WD-css-variables-20120509/">http://www.w3.org/TR/2012/ED-css-variables-20120509/</a>-->
28+
<!--<dd><a href="http://www.w3.org/TR/2012/WD-css-variables-20120510/">http://www.w3.org/TR/2012/ED-css-variables-20120510/</a>-->
2929

3030

3131
<dd><a href="http://dev.w3.org/csswg/css-variables/">Editor's draft</a>
32-
(version of 9 May 2012)
32+
(version of 10 May 2012)
3333

3434
<dt>Latest version:
3535

css3-flexbox/Overview.html

Lines changed: 70 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -30,11 +30,11 @@
3030

3131
<h1 id=head-box-flexible>CSS Flexible Box Layout Module</h1>
3232

33-
<h2 class="no-num no-toc" id=w3c-working>Editor's Draft, 9 May 2012</h2>
33+
<h2 class="no-num no-toc" id=w3c-working>Editor's Draft, 10 May 2012</h2>
3434

3535
<dl>
3636
<dt>This version:
37-
<!--<dd><a href="http://www.w3.org/TR/2012/ED-css3-flexbox-20120509/">http://www.w3.org/TR/2012/WD-css3-flexbox-20120509/</a>-->
37+
<!--<dd><a href="http://www.w3.org/TR/2012/ED-css3-flexbox-20120510/">http://www.w3.org/TR/2012/WD-css3-flexbox-20120510/</a>-->
3838

3939

4040
<dd><a
@@ -870,7 +870,8 @@ <h3 id=flex-direction><span class=secno>6.1. </span> Flexbox Flow
870870
<tr>
871871
<th>Canonical Order:
872872

873-
<td>as specified
873+
<td><abbr title="follows order of property value definition">per
874+
grammar</abbr>
874875
</table>
875876

876877
<p> The &lsquo;<a href="#flex-direction0"><code
@@ -974,7 +975,8 @@ <h3 id=flex-wrap><span class=secno>6.2. </span> Flexbox Wrapping: the
974975
<tr>
975976
<th>Canonical Order:
976977

977-
<td>as specified
978+
<td><abbr title="follows order of property value definition">per
979+
grammar</abbr>
978980
</table>
979981

980982
<p> The &lsquo;<a href="#flex-wrap0"><code
@@ -1072,7 +1074,8 @@ <h3 id=flex-flow><span class=secno>6.3. </span> Flex Direction and Wrap:
10721074
<tr>
10731075
<th>Canonical Order:
10741076

1075-
<td>as specified
1077+
<td><abbr title="follows order of property value definition">per
1078+
grammar</abbr>
10761079
</table>
10771080

10781081
<p>The &lsquo;<a href="#flex-flow0"><code
@@ -1175,7 +1178,8 @@ <h3 id=flex-order><span class=secno>6.4. </span> Display Order: the
11751178
<tr>
11761179
<th>Canonical Order:
11771180

1178-
<td>as specified
1181+
<td><abbr title="follows order of property value definition">per
1182+
grammar</abbr>
11791183
</table>
11801184

11811185
<p>The &lsquo;<a href="#flex-order0"><code
@@ -1275,9 +1279,10 @@ <h2 id=flexibility><span class=secno>7. </span> Flexibility: the &lsquo;<a
12751279
href="#flexbox-item"><i>flexbox items</i></a> "flex", altering their width
12761280
or height to fill the available space. This is done with the &lsquo;<a
12771281
href="#flex"><code class=property>flex</code></a>&rsquo; property. A
1278-
flexbox distributes free space to its items proportional to their positive
1279-
flexibility, or shrinks them to prevent overflow proportional to their
1280-
negative flexibility.
1282+
flexbox distributes free space to its items proportional to their <a
1283+
href="#positive-flexibility"><i>positive flex ratio</i></a>, or shrinks
1284+
them to prevent overflow proportional to their <a
1285+
href="#negative-flex-ratio"><i>negative flex ratio</i></a>.
12811286

12821287
<table class=propdef>
12831288
<tbody>
@@ -1310,8 +1315,7 @@ <h2 id=flexibility><span class=secno>7. </span> Flexibility: the &lsquo;<a
13101315
<tr>
13111316
<th>Computed Value:
13121317

1313-
<td>Two numbers for positive and negative flex, and a flex basis given
1314-
either as an absolute length or a keyword.
1318+
<td>see individual properties
13151319

13161320
<tr>
13171321
<th>Media:
@@ -1445,7 +1449,8 @@ <h3 id=flex-components><span class=secno>7.1. </span> Components of
14451449
<tr>
14461450
<th>Canonical Order:
14471451

1448-
<td>as specified
1452+
<td><abbr title="follows order of property value definition">per
1453+
grammar</abbr>
14491454
</table>
14501455

14511456
<p> The &lsquo;<a href="#flex-grow"><code
@@ -1499,7 +1504,8 @@ <h3 id=flex-components><span class=secno>7.1. </span> Components of
14991504
<tr>
15001505
<th>Canonical Order:
15011506

1502-
<td>as specified
1507+
<td><abbr title="follows order of property value definition">per
1508+
grammar</abbr>
15031509
</table>
15041510

15051511
<p> The &lsquo;<a href="#flex-shrink"><code
@@ -1537,7 +1543,7 @@ <h3 id=flex-components><span class=secno>7.1. </span> Components of
15371543
<tr>
15381544
<th>Computed Value:
15391545

1540-
<td>specified value
1546+
<td>an absolute length, or a percentage or a keyword as specified
15411547

15421548
<tr>
15431549
<th>Media:
@@ -1553,7 +1559,8 @@ <h3 id=flex-components><span class=secno>7.1. </span> Components of
15531559
<tr>
15541560
<th>Canonical Order:
15551561

1556-
<td>as specified
1562+
<td><abbr title="follows order of property value definition">per
1563+
grammar</abbr>
15571564
</table>
15581565

15591566
<p> The &lsquo;<a href="#flex-basis0"><code
@@ -1562,7 +1569,7 @@ <h3 id=flex-components><span class=secno>7.1. </span> Components of
15621569

15631570
<p> If the <var>&lt;&apos;width&apos;></var> component is &lsquo;<code
15641571
class=css>auto</code>&rsquo; on a child of a <a
1565-
href="#flexbox"><i>flexbox</i></a>, the <a href="#flex-basis"><i>flex
1572+
href="#flexbox"><i>flexbox</i></a>, the used <a href="#flex-basis"><i>flex
15661573
basis</i></a> is the computed value of the <a
15671574
href="#main-size-property"><i>main size property</i></a>.
15681575

@@ -1691,7 +1698,8 @@ <h3 id=flex-pack><span class=secno>8.2. </span> Axis Alignment: the
16911698
<tr>
16921699
<th>Canonical Order:
16931700

1694-
<td>as specified
1701+
<td><abbr title="follows order of property value definition">per
1702+
grammar</abbr>
16951703
</table>
16961704

16971705
<p> The &lsquo;<a href="#flex-pack0"><code
@@ -1831,7 +1839,8 @@ <h3 id=flex-align><span class=secno>8.3. </span> Cross-axis Alignment: the
18311839
<tr>
18321840
<th>Canonical Order:
18331841

1834-
<td>as specified
1842+
<td><abbr title="follows order of property value definition">per
1843+
grammar</abbr>
18351844
</table>
18361845

18371846
<table class=propdef>
@@ -1881,7 +1890,8 @@ <h3 id=flex-align><span class=secno>8.3. </span> Cross-axis Alignment: the
18811890
<tr>
18821891
<th>Canonical Order:
18831892

1884-
<td>as specified
1893+
<td><abbr title="follows order of property value definition">per
1894+
grammar</abbr>
18851895
</table>
18861896

18871897
<p> <a href="#flexbox-item"><i>Flexbox items</i></a> can be aligned in the
@@ -2053,7 +2063,8 @@ <h3 id=flex-line-pack><span class=secno>8.4. </span> &lsquo;<a
20532063
<tr>
20542064
<th>Canonical Order:
20552065

2056-
<td>as specified
2066+
<td><abbr title="follows order of property value definition">per
2067+
grammar</abbr>
20572068
</table>
20582069

20592070
<p>The &lsquo;<a href="#flex-line-pack0"><code
@@ -2202,9 +2213,13 @@ <h2 id=layout-algorithm><span class=secno>9. </span> Flexbox Layout
22022213
-->
22032214

22042215

2205-
<p> A size is <dfn id=definite title="definite|indefinite">definite</dfn>
2206-
if it is a <var>&lt;length></var>, or it is a <var>&lt;percentage></var>
2207-
that is resolved against a definite size.
2216+
<p> For the purposes of these definitions, a <dfn id=definite-size
2217+
title="definite|definite size">definite size</dfn> is one that can be
2218+
determined without measuring content, i.e. is a &lt;length>, a size of the
2219+
initial containing block, or a &lt;percentage> that is resolved against a
2220+
definite size. An <dfn id=indefinite-size
2221+
title="indefinite|indefinite size">indefinite size</dfn> is one that is
2222+
not <a href="#definite-size"><i>definite</i></a>.
22082223

22092224
<p> The following sections define the algorithm for laying out a flexbox
22102225
and its contents.
@@ -2233,21 +2248,22 @@ <h3 id=line-sizing><span class=secno>9.2. </span> Line Length Determination</h3>
22332248
<ol start=2>
22342249
<li id=algo-available> <strong>Determine the available main and cross
22352250
space for the flexbox items.</strong> For each dimension, if that
2236-
dimension of the flexbox is a <i>definite size</i>, use that; otherwise,
2237-
subtract the flexbox's margin, border, and padding from the space
2238-
available to the flexbox in that dimension and use that value. <span
2239-
class=note>This might result in an infinite value.</span>
2251+
dimension of the flexbox is a <a href="#definite-size"><i>definite
2252+
size</i></a>, use that; otherwise, subtract the flexbox's margin, border,
2253+
and padding from the space available to the flexbox in that dimension and
2254+
use that value. <span class=note>This might result in an infinite
2255+
value.</span>
22402256

22412257
<li id=algo-main-item> <strong>Determine the hypothetical main size of
22422258
each item:</strong>
22432259
<ul>
2244-
<li> If the item has a <a href="#definite"><i>definite</i></a> flex
2260+
<li> If the item has a <a href="#definite-size"><i>definite</i></a> flex
22452261
basis, that's the hypothetical size.
22462262

22472263
<li> Otherwise, if the flexbox's main-axis is parallel to the item's
22482264
inline-axis, lay out the item using its flex basis and the available
22492265
space, treating &lsquo;<code class=css>auto</code>&rsquo; as
2250-
&lsquo;<code class=css>fit-content</code>&rsquo; unless the item's
2266+
&lsquo;<code class=css>max-content</code>&rsquo; unless the item's
22512267
writing mode is perpendicular to the flexbox's writing mode (in which
22522268
case <a
22532269
href="http://www.w3.org/TR/css3-writing-modes/#orthogonal-flows">the
@@ -2262,7 +2278,7 @@ <h3 id=line-sizing><span class=secno>9.2. </span> Line Length Determination</h3>
22622278

22632279
<li> Otherwise, lay out the item using the available space, treating
22642280
&lsquo;<code class=css>auto</code>&rsquo; as &lsquo;<code
2265-
class=css>fit-content</code>&rsquo; unless the item's writing mode is
2281+
class=css>max-content</code>&rsquo; unless the item's writing mode is
22662282
perpendicular to the flexbox's writing mode (in which case <a
22672283
href="http://www.w3.org/TR/css3-writing-modes/#orthogonal-flows">the
22682284
rules for a box in an orthogonal flow</a> <a href="#CSS3-WRITING-MODES"
@@ -2333,12 +2349,14 @@ <h3 id=cross-sizing><span class=secno>9.4. </span> Cross size determination</h3>
23332349
line.</strong> For each flexbox line:
23342350
<ol>
23352351
<li> Collect all the flexbox items whose inline-axis is parallel to the
2336-
main-axis and whose &lsquo;<a href="#flex-item-align"><code
2352+
main-axis, whose &lsquo;<a href="#flex-item-align"><code
23372353
class=property>flex-item-align</code></a>&rsquo; is &lsquo;<code
2338-
class=css>baseline</code>&rsquo;. Find the largest of the distances
2339-
between each item's baseline and its hypothetical outer cross-start
2340-
edge, and the largest of the distances between each item's baseline and
2341-
its hypothetical outer cross-end edge, and sum these two values.
2354+
class=css>baseline</code>&rsquo;, and whose cross-axis margins are both
2355+
non-&lsquo;<code class=css>auto</code>&rsquo;. Find the largest of the
2356+
distances between each item's baseline and its hypothetical outer
2357+
cross-start edge, and the largest of the distances between each item's
2358+
baseline and its hypothetical outer cross-end edge, and sum these two
2359+
values.
23422360

23432361
<li> Among all the items not collected by the previous step, find the
23442362
largest hypothetical outer cross-size.
@@ -2347,8 +2365,8 @@ <h3 id=cross-sizing><span class=secno>9.4. </span> Cross size determination</h3>
23472365
found in the previous two steps.
23482366
</ol>
23492367

2350-
<p> If the flexbox has a <a href="#definite"><i>definite</i></a> cross
2351-
size, &lsquo;<a href="#flex-line-pack0"><code
2368+
<p> If the flexbox has a <a href="#definite-size"><i>definite</i></a>
2369+
cross size, &lsquo;<a href="#flex-line-pack0"><code
23522370
class=property>flex-line-pack</code></a>&rsquo; is &lsquo;<code
23532371
class=css>stretch</code>&rsquo;, and the sum of the flexbox lines' cross
23542372
sizes is less than the flexbox's inner cross size, increase the cross
@@ -2400,7 +2418,7 @@ <h3 id=cross-alignment><span class=secno>9.6. </span> Cross-Axis Alignment</h3>
24002418
size:</strong>
24012419
<ul>
24022420
<li> If the cross size property is a <a
2403-
href="#definite"><i>definite</i></a> size, use that.
2421+
href="#definite-size"><i>definite</i></a> size, use that.
24042422

24052423
<li> Otherwise, use the sum of the flexbox lines' cross sizes.
24062424
</ul>
@@ -2419,8 +2437,9 @@ <h3 id=resolve-flexible-lengths><span class=secno>9.7. </span> Resolving
24192437
<li> <strong>Determine the used flexibility.</strong> Sum the hypothetical
24202438
outer main sizes of all items on the line, clamped according to their min
24212439
and max main size properties. If the sum is greater than the flexbox's
2422-
inner main size, use positive flexibility for the rest of this algorithm;
2423-
otherwise, use negative flexibility.
2440+
inner main size, use the <a href="#positive-flexibility"><i>positive flex
2441+
ratio</i></a> for the rest of this algorithm; otherwise, use the <a
2442+
href="#negative-flex-ratio"><i>negative flex ratio</i></a>.
24242443

24252444
<li> <strong>Check that you can distribute any space.</strong> If all the
24262445
flexbox items on the line are either frozen or have a flexibility of
@@ -3002,8 +3021,7 @@ <h2 class=no-num id=property>Property index</h2>
30023021

30033022
<td>see individual properties
30043023

3005-
<td>Two numbers for positive and negative flex, and a flex basis given
3006-
either as an absolute length or a keyword.
3024+
<td>see individual properties
30073025

30083026
<td>visual
30093027

@@ -3033,7 +3051,7 @@ <h2 class=no-num id=property>Property index</h2>
30333051

30343052
<td>no
30353053

3036-
<td>specified value
3054+
<td>an absolute length, or a percentage or a keyword as specified
30373055

30383056
<td>visual
30393057

@@ -3217,7 +3235,11 @@ <h2 class=no-num id=index>Index</h2>
32173235
<li>cross-start, <a href="#cross-start"
32183236
title=cross-start><strong>2.</strong></a>
32193237

3220-
<li>definite, <a href="#definite" title=definite><strong>9.</strong></a>
3238+
<li>definite, <a href="#definite-size"
3239+
title=definite><strong>9.</strong></a>
3240+
3241+
<li>definite size, <a href="#definite-size"
3242+
title="definite size"><strong>9.</strong></a>
32213243

32223244
<li>&lsquo;<code class=css>distribute</code>&rsquo;, <a
32233245
href="#flex-line-pack-distribute"
@@ -3289,9 +3311,12 @@ <h2 class=no-num id=index>Index</h2>
32893311
<li>flex-wrap, <a href="#flex-wrap0"
32903312
title=flex-wrap><strong>6.2.</strong></a>
32913313

3292-
<li>indefinite, <a href="#definite"
3314+
<li>indefinite, <a href="#indefinite-size"
32933315
title=indefinite><strong>9.</strong></a>
32943316

3317+
<li>indefinite size, <a href="#indefinite-size"
3318+
title="indefinite size"><strong>9.</strong></a>
3319+
32953320
<li>inline-flex, <a href="#display-inline-flex"
32963321
title=inline-flex><strong>3.</strong></a>
32973322

0 commit comments

Comments
 (0)