Skip to content

Commit b047799

Browse files
committed
Slight rewrite of flex-pack to make it clear it's per-line.
1 parent 1c1fe6f commit b047799

2 files changed

Lines changed: 44 additions & 42 deletions

File tree

css3-flexbox/Overview.html

Lines changed: 39 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -1107,53 +1107,61 @@ <h3 id=flex-pack><span class=secno>5.1. </span> Main Axis Alignment: the
11071107
<td>visual
11081108
</table>
11091109

1110-
<p>Between and around the margins of <a href="#flexbox-item"><i>flexbox
1111-
items</i></a> there are additional flexible lengths, called <dfn
1112-
id=packing-space>packing space</dfn>. Packing space can absorb leftover
1113-
free space in a flexbox if there aren't any other <a
1114-
href="#flexible-length0"><i>flexible length</i></a>s, or if all the <a
1115-
href="#flexible-length0"><i>flexible length</i></a>s have reached their
1110+
<p>Between and around <a href="#flexbox-item"><i>flexbox items</i></a>
1111+
there are additional flexible lengths called <dfn id=packing-space
1112+
title="packing space|packing spaces">packing spaces</dfn>. <a
1113+
href="#packing-space"><i>Packing spaces</i></a> can absorb leftover free
1114+
space in a flexbox line if there aren't any other <a
1115+
href="#flexible-length0"><i>flexible lengths</i></a>, or if all the <a
1116+
href="#flexible-length0"><i>flexible lengths</i></a> have reached their
11161117
maximum size. The &lsquo;<a href="#flex-pack0"><code
11171118
class=property>flex-pack</code></a>&rsquo; property defines the
1118-
flexibility of these packing spaces:
1119+
flexibility of <a href="#packing-space"><i>packing spaces</i></a>:
11191120

11201121
<dl>
11211122
<dt><dfn id=flex-pack-start>start</dfn>
11221123

1123-
<dd><a href="#flexbox-item"><i>flexbox items</i></a> are packed toward the
1124-
start of the flexbox. The last packing space (between the margin of the
1125-
last flexbox item and the edge of the flexbox) must absorb all leftover
1126-
free space; all other packing spaces must have a length of &lsquo;<code
1124+
<dd><a href="#flexbox-item"><i>Flexbox items</i></a> are packed toward the
1125+
start of the flexbox line. The last <a href="#packing-space"><i>packing
1126+
space</i></a> on the line (between the margin of the last <a
1127+
href="#flexbox-item"><i>flexbox item</i></a> on the line and the edge of
1128+
the flexbox) must absorb all leftover free space; all other packing
1129+
spaces on the line must have a length of &lsquo;<code
11271130
class=css>0</code>&rsquo;.
11281131

11291132
<dt><dfn id=flex-pack-end>end</dfn>
11301133

1131-
<dd><a href="#flexbox-item"><i>flexbox items</i></a> are packed toward the
1132-
end of the flexbox. The first packing space (between the edge of the
1133-
flexbox and the margin of the first flexbox item) must absorb all
1134-
leftover free space; all other packing spaces must have a length of
1135-
&lsquo;<code class=css>0</code>&rsquo;.
1134+
<dd><a href="#flexbox-item"><i>Flexbox items</i></a> are packed toward the
1135+
end of the flexbox line. The first <a href="#packing-space"><i>packing
1136+
space</i></a> on the line (between the edge of the flexbox and the margin
1137+
of the first <a href="#flexbox-item"><i>flexbox item</i></a> on the line)
1138+
must absorb all leftover free space; all other <a
1139+
href="#packing-space"><i>packing spaces</i></a> on the line must have a
1140+
length of &lsquo;<code class=css>0</code>&rsquo;.
11361141

11371142
<dt><dfn id=flex-pack-center>center</dfn>
11381143

1139-
<dd><a href="#flexbox-item"><i>flexbox items</i></a> are packed toward the
1140-
center of the flexbox. The first and last packing spaces must equally
1141-
split all leftover free space; all other packing spaces must have a
1144+
<dd><a href="#flexbox-item"><i>Flexbox items</i></a> are packed toward the
1145+
center of the flexbox line. The first and last <a
1146+
href="#packing-space"><i>packing spaces</i></a> on the line must equally
1147+
split all leftover free space; all other <a
1148+
href="#packing-space"><i>packing spaces</i></a> on the line must have a
11421149
length of &lsquo;<code class=css>0</code>&rsquo;.
11431150

11441151
<dt><dfn id=flex-pack-justify>justify</dfn>
11451152

1146-
<dd><a href="#flexbox-item"><i>flexbox items</i></a> are evenly
1147-
distributed through the flexbox. The first and last packing spaces must
1148-
have a length of &lsquo;<code class=css>0</code>&rsquo;; all other
1149-
packing spaces must equally split all leftover free space.
1153+
<dd><a href="#flexbox-item"><i>Flexbox items</i></a> are evenly
1154+
distributed in the flexbox line. If there is more than one <a
1155+
href="#flexbox-item"><i>flexbox item</i></a> on the line, the first and
1156+
last <a href="#packing-space"><i>packing spaces</i></a> on the line must
1157+
have a length of &lsquo;<code class=css>0</code>&rsquo; and all other <a
1158+
href="#packing-space"><i>packing spaces</i></a> on the line must equally
1159+
split all leftover free space. Otherwise, &lsquo;<a
1160+
href="#flex-pack-justify"><code class=css>justify</code></a>&rsquo; must
1161+
act identically to &lsquo;<a href="#flex-pack-start"><code
1162+
class=css>start</code></a>&rsquo;.
11501163
</dl>
11511164

1152-
<div class=figure>
1153-
<p class=caption><span class=issue>TODO: Provide a diagram showing packing
1154-
spaces.</span></p>
1155-
</div>
1156-
11571165
<div class=example>
11581166
<p class=issue>TODO: Examples showing the four values.</p>
11591167
</div>
@@ -2433,6 +2441,9 @@ <h2 class=no-num id=index>Index</h2>
24332441
<li>packing space, <a href="#packing-space" title="packing
24342442
space"><strong>5.1.</strong></a>
24352443

2444+
<li>packing spaces, <a href="#packing-space" title="packing
2445+
spaces"><strong>5.1.</strong></a>
2446+
24362447
<li>positive flexibility, <a href="#positive-flexibility" title="positive
24372448
flexibility"><strong>4.1.</strong></a>
24382449

css3-flexbox/Overview.src.html

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -497,31 +497,22 @@ <h3 id='flex-pack'>
497497
<td>visual
498498
</table>
499499

500-
<p>Between and around the margins of <i>flexbox items</i> there are additional
501-
flexible lengths, called <dfn>packing space</dfn>. Packing space can absorb
502-
leftover free space in a flexbox if there aren't any other <i>flexible length</i>s,
503-
or if all the <i>flexible length</i>s have reached their maximum size. The
504-
'flex-pack' property defines the flexibility of these packing spaces:
500+
<p>Between and around <i>flexbox items</i> there are additional flexible lengths called <dfn id="packing-space" title="packing space|packing spaces">packing spaces</dfn>. <i>Packing spaces</i> can absorb leftover free space in a flexbox line if there aren't any other <i>flexible lengths</i>, or if all the <i>flexible lengths</i> have reached their maximum size. The 'flex-pack' property defines the flexibility of <i>packing spaces</i>:</p>
505501

506502
<dl>
507503
<dt><dfn id='flex-pack-start'>start</dfn></dt>
508-
<dd><i>flexbox items</i> are packed toward the start of the flexbox. The last packing space (between the margin of the last flexbox item and the edge of the flexbox) must absorb all leftover free space; all other packing spaces must have a length of ''0''.</dd>
504+
<dd><i>Flexbox items</i> are packed toward the start of the flexbox line. The last <i>packing space</i> on the line (between the margin of the last <i>flexbox item</i> on the line and the edge of the flexbox) must absorb all leftover free space; all other packing spaces on the line must have a length of ''0''.</dd>
509505

510506
<dt><dfn id='flex-pack-end'>end</dfn></dt>
511-
<dd><i>flexbox items</i> are packed toward the end of the flexbox. The first packing space (between the edge of the flexbox and the margin of the first flexbox item) must absorb all leftover free space; all other packing spaces must have a length of ''0''.</dd>
507+
<dd><i>Flexbox items</i> are packed toward the end of the flexbox line. The first <i>packing space</i> on the line (between the edge of the flexbox and the margin of the first <i>flexbox item</i> on the line) must absorb all leftover free space; all other <i>packing spaces</i> on the line must have a length of ''0''.</dd>
512508

513509
<dt><dfn id='flex-pack-center'>center</dfn></dt>
514-
<dd><i>flexbox items</i> are packed toward the center of the flexbox. The first and last packing spaces must equally split all leftover free space; all other packing spaces must have a length of ''0''.</dd>
510+
<dd><i>Flexbox items</i> are packed toward the center of the flexbox line. The first and last <i>packing spaces</i> on the line must equally split all leftover free space; all other <i>packing spaces</i> on the line must have a length of ''0''.</dd>
515511

516512
<dt><dfn id='flex-pack-justify'>justify</dfn></dt>
517-
<dd><i>flexbox items</i> are evenly distributed through the flexbox. The first and last packing spaces must have a length of ''0''; all other packing spaces must equally split all leftover free space.</dd>
513+
<dd><i>Flexbox items</i> are evenly distributed in the flexbox line. If there is more than one <i>flexbox item</i> on the line, the first and last <i>packing spaces</i> on the line must have a length of ''0'' and all other <i>packing spaces</i> on the line must equally split all leftover free space. Otherwise, ''justify'' must act identically to ''start''.</dd>
518514
</dl>
519515

520-
<div class=figure>
521-
<p class=caption><span class=issue>TODO: Provide a diagram showing packing
522-
spaces.</span></p>
523-
</div>
524-
525516
<div class=example>
526517
<p class=issue>TODO: Examples showing the four values.</p>
527518
</div>

0 commit comments

Comments
 (0)