Skip to content

Commit

Permalink
[css-flexbox] Editorial fixes to the AMS section. Part of w3c#2385.
Browse files Browse the repository at this point in the history
  • Loading branch information
tabatkins authored and fergald committed May 7, 2018
1 parent 1cd31dc commit 0c523a4
Showing 1 changed file with 18 additions and 24 deletions.
42 changes: 18 additions & 24 deletions css-flexbox-1/Overview.bs
Original file line number Diff line number Diff line change
Expand Up @@ -897,23 +897,17 @@ Collapsed Items</h3>
<h3 id="min-size-auto">
Automatic Minimum Size of Flex Items</h3>

Note: The ''min-width/auto'' value of 'min-width' and 'min-height' is new.
It was initially introduced as the new initial value of these properties
in this specification;
its formal definition has now been moved
to the <a href="http://www.w3.org/TR/css-sizing/">CSS Sizing</a> module.
It is still required for a complete and correct implementation
of this module.

To provide a more reasonable default minimum size for <a>flex items</a>,
this specification defines that the ''min-width/auto'' keyword
of the 'min-width' and 'min-height' properties
[[!CSS-SIZING-3]]
(which represents their initial value)
applies a <dfn for="flexbox">content-based minimum size</dfn>
to <a>flex items</a> whose 'overflow' is ''overflow/visible'' in the <a>main axis</a>;
any other 'overflow' value causes the <a>automatic minimum size</a> to be zero,
as usual.
Note: The ''min-width/auto'' keyword,
representing an <a>automatic minimum size</a>,
is the new initial value of the 'min-width' and 'min-height' properties.
The keyword was previously defined in this specification,
but is now defined in the [[!CSS-SIZING-3|CSS Sizing]] module.

To provide a more reasonable default <a>minimum size</a> for <a>flex items</a>,
the used value of a <a>main axis</a> <a>automatic minimum size</a>
on a <a>flex item</a> whose 'overflow' is ''overflow/visible'' in the <a>main axis</a>
is a <dfn>content-based minimum size</dfn>;
any other 'overflow' value means the <a>automatic minimum size</a> is zero, as usual.

In general, the <a>content-based minimum size</a> of a <a>flex item</a>
is the smaller of its <a>content size suggestion</a> and its <a>specified size suggestion</a>.
Expand All @@ -929,14 +923,14 @@ Automatic Minimum Size of Flex Items</h3>
and are defined below:

<dl>
<dt><dfn dfn noexport>specified size suggestion</dfn>
<dt><dfn>specified size suggestion</dfn>
<dd>
If the item’s computed <a>main size property</a> is <a>definite</a>,
then the <a>specified size suggestion</a> is that size
(clamped by its <a>max main size property</a> if it's <a>definite</a>).
It is otherwise undefined.

<dt><dfn dfn noexport>transferred size suggestion</dfn>
<dt><dfn>transferred size suggestion</dfn>
<dd>
If the item has an intrinsic aspect ratio
and its computed <a>cross size property</a> is <a>definite</a>,
Expand All @@ -945,19 +939,19 @@ Automatic Minimum Size of Flex Items</h3>
converted through the aspect ratio.
It is otherwise undefined.

<dt><dfn dfn noexport>content size suggestion</dfn>
<dt><dfn>content size suggestion</dfn>
<dd>
The <a>content size suggestion</a> is the <a>min-content size</a> in the <a>main axis</a>,
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,
and then further clamped by the <a>max main size property</a> if that is <a>definite</a>.
</dl>

For the purpose of calculating an intrinsic size of the element
(e.g. the element's <a>min-content size</a>),
this value causes the element's size in that axis to become indefinite
For the purpose of calculating an intrinsic size of the box
(e.g. the box’s <a>min-content size</a>),
this value causes the box’s size in that axis to become indefinite
(even if e.g. its 'width' property specifies a <a>definite</a> size).
Note this means that percentages calculated against this size
will be treated as ''height/auto''.
will [=behave as auto=].

Nonetheless, although this may require an additional layout pass to re-resolve percentages in some cases,
this value
Expand Down

0 comments on commit 0c523a4

Please sign in to comment.