Skip to content

Commit ae752d1

Browse files
committed
Add Changes section
1 parent 12617eb commit ae752d1

2 files changed

Lines changed: 144 additions & 4 deletions

File tree

css3-flexbox/Overview.html

Lines changed: 86 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -354,6 +354,8 @@ <h2 class="no-num no-toc" id=table>Table of contents</h2>
354354
<li class=no-num><a href="#informative">Other references</a>
355355
</ul>
356356

357+
<li class=no-num><a href="#changes">Changes</a>
358+
357359
<li class=no-num><a href="#property">Property index</a>
358360

359361
<li class=no-num><a href="#index">Index</a>
@@ -3336,6 +3338,90 @@ <h3 class=no-num id=informative>Other references</h3>
33363338
</dl>
33373339
<!--end-informative-->
33383340

3341+
<h2 class=no-num id=changes>Changes</h2>
3342+
3343+
<p> The following major changes were made since the <a
3344+
href="http://www.w3.org/TR/2012/WD-css3-flexbox-20120322/">22 March 2012
3345+
Working Draft</a>:
3346+
3347+
<ul>
3348+
<li> The ‘<code class=property>display</code>’ values for flex
3349+
containers were changed from ‘<code class=css>flexbox</code>’ and
3350+
<code class=css>inline-flexbox</code>’ to ‘<a href="#flex"><code
3351+
class=css>flex</code></a>’ and ‘<a href="#display-inline-flex"><code
3352+
class=css>inline-flex</code></a>’.
3353+
3354+
<li> The alignment properties and values were renamed to align with the
3355+
new <a href="http://www.w3.org/TR/css3-align/">Box Alignment</a> module:
3356+
<ul>
3357+
<li><code class=property>flex-align</code>’ → ‘<a
3358+
href="#align-items"><code class=property>align-items</code></a>
3359+
3360+
<li><code class=property>flex-item-align</code>’ → ‘<a
3361+
href="#align-self"><code class=property>align-self</code></a>
3362+
3363+
<li><code class=property>flex-line-pack</code>’ → ‘<a
3364+
href="#align-content"><code class=property>align-content</code></a>
3365+
3366+
<li><code class=property>flex-pack</code>’ → ‘<a
3367+
href="#justify-content"><code
3368+
class=property>justify-content</code></a>
3369+
</ul>
3370+
3371+
<li> The ‘<code class=property>flex-order</code>’ property was renamed
3372+
to ‘<a href="#order"><code class=property>order</code></a>’, to allow
3373+
it to be used with other layout models in the future.
3374+
3375+
<li> The ‘<a href="#flex"><code class=property>flex</code></a>
3376+
shorthand has been split into the ‘<a href="#flex-grow"><code
3377+
class=property>flex-grow</code></a>’, ‘<a href="#flex-shrink"><code
3378+
class=property>flex-shrink</code></a>’, and ‘<a
3379+
href="#flex-basis0"><code class=property>flex-basis</code></a>
3380+
longhands.
3381+
3382+
<li> Negative free space is distributed in proportion to the flex basis ×
3383+
flex shrink ratio, rather than just the flex shrink ratio.
3384+
3385+
<li> Flex items are allowed to shrink by default. (The initial value of
3386+
<a href="#flex-shrink"><code class=property>flex-shrink</code></a>
3387+
is ‘<code class=css>1</code>’.)
3388+
3389+
<li> A new <a href="#min-size-auto"><code class=css>auto</code>
3390+
value for ‘<code class=css>min-width/height</code></a> was added to
3391+
set a reasonable default minimum main size for flex items.
3392+
3393+
<li> The <a href="#visibility-collapse">effect of ‘<code
3394+
class=css>visibility: collapse</code></a> on flex items is now
3395+
defined.
3396+
3397+
<li> Inline replaced elements are no longer promoted to flex items;
3398+
instead certain HTML elements intended to be replaced elements are
3399+
promoted to flex items. This produces a consistent layout model
3400+
regardless of whether the replaced content can be loaded.
3401+
3402+
<li> For <a href="#pagination">pagination</a>, the effect and propagation
3403+
of page-breaking controls has been tweaked and clarified, and most of the
3404+
details of fragmentation are now informative, allowing UAs to do better.
3405+
3406+
<li> The flex layout algorithm has received an editorial overhaul, and
3407+
many error fixes and clarifications were made.
3408+
3409+
<li> A lot of terminology was updated to make it less confusing:
3410+
<ul>
3411+
<li>flexbox → flex container
3412+
3413+
<li>flexbox item → flex item
3414+
3415+
<li>positive flexibility → flex grow ratio
3416+
3417+
<li>negative flexibility → flex shrink ratio
3418+
3419+
<li>preferred size → flex basis
3420+
3421+
<li>hypothetical main size → flex base size
3422+
</ul>
3423+
</ul>
3424+
33393425
<h2 class=no-num id=property>Property index</h2>
33403426
<!--begin-properties-->
33413427

@@ -3408,13 +3494,11 @@ <h2 class=no-num id=property>Property index</h2>
34083494
<th><span class=property>display</span>
34093495

34103496
<td>flex | inline-flex
3411-
34123497
<td>
34133498
<td>
34143499
<td>
34153500
<td>
34163501
<td>
3417-
34183502
<tr>
34193503
<th><a class=property href="#flex">flex</a>
34203504

@@ -3545,11 +3629,9 @@ <h2 class=no-num id=property>Property index</h2>
35453629
<td>auto
35463630

35473631
<td>the percentage as specified or the absolute length or a keyword
3548-
35493632
<td>
35503633
<td>
35513634
<td>
3552-
35533635
<tr>
35543636
<th><a class=property href="#order">order</a>
35553637

css3-flexbox/Overview.src.html

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2663,6 +2663,64 @@ <h3 class="no-num" id="normative">Normative references</h3>
26632663
<h3 class="no-num" id="informative">Other references</h3>
26642664
<!--informative-->
26652665

2666+
<h2 class="no-num" id="changes">Changes</h2>
2667+
2668+
<p>
2669+
The following major changes were made since the
2670+
<a href="http://www.w3.org/TR/2012/WD-css3-flexbox-20120322/">22 March 2012 Working Draft</a>:
2671+
<ul>
2672+
<li>
2673+
The 'display' values for flex containers were changed
2674+
from ''flexbox'' and ''inline-flexbox'' to ''flex'' and ''inline-flex''.
2675+
<li>
2676+
The alignment properties and values were renamed to align with the new
2677+
<a href="http://www.w3.org/TR/css3-align/">Box Alignment</a> module:
2678+
<ul>
2679+
<li>'flex-align' &rarr; 'align-items'
2680+
<li>'flex-item-align' &rarr; 'align-self'
2681+
<li>'flex-line-pack' &rarr; 'align-content'
2682+
<li>'flex-pack' &rarr; 'justify-content'
2683+
</ul>
2684+
<li>
2685+
The 'flex-order' property was renamed to 'order',
2686+
to allow it to be used with other layout models in the future.
2687+
<li>
2688+
The 'flex' shorthand has been split into the 'flex-grow', 'flex-shrink', and 'flex-basis' longhands.
2689+
<li>
2690+
Negative free space is distributed in proportion to the flex basis &times; flex shrink ratio,
2691+
rather than just the flex shrink ratio.
2692+
<li>
2693+
Flex items are allowed to shrink by default. (The initial value of 'flex-shrink' is ''1''.)
2694+
<li>
2695+
A new <a href="#min-size-auto">''auto'' value for 'min-width/height'</a> was added
2696+
to set a reasonable default minimum main size for flex items.
2697+
<li>
2698+
The <a href="#visibility-collapse">effect of ''visibility: collapse''</a>
2699+
on flex items is now defined.
2700+
<li>
2701+
Inline replaced elements are no longer promoted to flex items;
2702+
instead certain HTML elements intended to be replaced elements are promoted to flex items.
2703+
This produces a consistent layout model regardless of whether the replaced content can be loaded.
2704+
<li>
2705+
For <a href="#pagination">pagination</a>, the effect and propagation of
2706+
page-breaking controls has been tweaked and clarified,
2707+
and most of the details of fragmentation are now informative,
2708+
allowing UAs to do better.
2709+
<li>
2710+
The flex layout algorithm has received an editorial overhaul,
2711+
and many error fixes and clarifications were made.
2712+
<li>
2713+
A lot of terminology was updated to make it less confusing:
2714+
<ul>
2715+
<li>flexbox &rarr; flex container
2716+
<li>flexbox item &rarr; flex item
2717+
<li>positive flexibility &rarr; flex grow ratio
2718+
<li>negative flexibility &rarr; flex shrink ratio
2719+
<li>preferred size &rarr; flex basis
2720+
<li>hypothetical main size &rarr; flex base size
2721+
</ul>
2722+
</ul>
2723+
26662724
<h2 id="property" class="no-num">Property index</h2>
26672725
<!--properties-->
26682726

0 commit comments

Comments
 (0)