Skip to content

Commit 279ab1d

Browse files
committed
Reworded opening of the flex() section to actually describe what flexibility does.
1 parent 59ac4c9 commit 279ab1d

2 files changed

Lines changed: 5 additions & 6 deletions

File tree

css3-flexbox/Overview.html

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1053,10 +1053,11 @@ <h2 id=flexibility><span class=secno>4. </span> Flexibility: the
10531053

10541054
<p>The defining aspect of flexbox layout is the ability to make the <a
10551055
href="#flexbox-item"><i>flexbox items</i></a> "flex", altering their width
1056-
or height to fill the available space. This is done by setting an
1056+
or height to fill the available space. This is done by using a &lsquo;<a
1057+
href="#ltflex"><code class=css>&lt;flex></code></a>&rsquo; value in the
10571058
element's &lsquo;<code class=property>width</code>&rsquo; or &lsquo;<code
1058-
class=property>height</code>&rsquo; to a <a
1059-
href="#flexible-length"><i>flexible length</i></a> value.
1059+
class=property>height</code>&rsquo; property. A flexbox distributes free
1060+
space proportionally to its items based on their flexibility.
10601061

10611062
<p>The &lsquo;<code class=css>flex()</code>&rsquo; notation is used to
10621063
specify the parameters of a <dfn id=flexible-length

css3-flexbox/Overview.src.html

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -498,7 +498,7 @@ <h3 id='flex-order'>
498498
<h2 id='flexibility'>
499499
Flexibility: the ''flex()'' notation</h2>
500500

501-
<p>The defining aspect of flexbox layout is the ability to make the <i>flexbox items</i> "flex", altering their width or height to fill the available space. This is done by setting an element's 'width' or 'height' to a <i>flexible length</i> value.</p>
501+
<p>The defining aspect of flexbox layout is the ability to make the <i>flexbox items</i> "flex", altering their width or height to fill the available space. This is done by using a ''&lt;flex>'' value in the element's 'width' or 'height' property. A flexbox distributes free space proportionally to its items based on their flexibility.</p>
502502

503503
<p>The ''flex()'' notation is used to specify the parameters of a <dfn title="flexible length|flexible lengths|flexible length's">flexible length</dfn>: the <dfn id="positive-flexibility" title="positive flexibility">positive</dfn> and <dfn>negative flexibility</dfn>, and the <dfn>preferred size</dfn>. The syntax of the ''flex()'' notation is:</p>
504504

@@ -601,8 +601,6 @@ <h3 id='flex-pack'>
601601
<p class='caption'>An illustration of the five 'flex-pack' keywords and their effects on a flexbox with three colored items.</p>
602602
</div>
603603

604-
<p class='note'>A previous revision of this spec allowed margins to flex directly, which allowed an effect similar to 'flex-pack'. In particular, it allowed an author to, for example, split a flexbox in half, with some of the items pushed toward the start and the rest pushed toward the end, by flexing exactly one margin. This sort of effect is no longer possible without either using the ::before or ::after pseudoelements or adding additional elements to the document, to act as an empty item that can then flex. It's expected that we will develop something in the future to make this easier, such as a more general pseudoelement or perhaps the ability to explicitly control individual spaces between flexbox items.</p>
605-
606604

607605
<h3 id='flex-align'>
608606
Cross Axis Alignment: the 'flex-align' and 'flex-item-align' properties</h3>

0 commit comments

Comments
 (0)