Skip to content

Commit 8537798

Browse files
committed
[css-flexbox-1][editorial] Miscellaneous bikeshed fixes.
1 parent 644b4ec commit 8537798

File tree

1 file changed

+23
-25
lines changed

1 file changed

+23
-25
lines changed

css-flexbox-1/Overview.bs

Lines changed: 23 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -441,7 +441,7 @@ Flex Layout Box Model and Terminology</h2>
441441

442442
Unlike block and inline layout,
443443
whose layout calculations are biased to the <a href="https://www.w3.org/TR/css3-writing-modes/#abstract-box">block and inline flow directions</a>,
444-
flex layout is biased to the <dfn lt="flex direction">flex directions</dfn>.
444+
flex layout is biased to the <dfn export lt="flex direction">flex directions</dfn>.
445445
To make it easier to talk about flex layout,
446446
this section defines a set of flex flow&ndash;relative terms.
447447
The 'flex-flow' value and the <a>writing mode</a>
@@ -678,7 +678,7 @@ Flex Items</h2>
678678
</div>
679679

680680
A <a>flex item</a> [=establishes an independent formatting context=] for its contents.
681-
However, flex items themselves are <dfn>flex-level</dfn> boxes, not block-level boxes:
681+
However, flex items themselves are <dfn export>flex-level</dfn> boxes, not block-level boxes:
682682
they participate in their container's flex formatting context,
683683
not in a block formatting context.
684684

@@ -822,9 +822,9 @@ Flex Item Z-Ordering</h3>
822822
Collapsed Items</h3>
823823

824824
Specifying ''visibility:collapse'' on a flex item
825-
causes it to become a <dfn lt="collapsed flex item" local-lt="collapsed">collapsed flex item</dfn>,
825+
causes it to become a <dfn export lt="collapsed flex item" local-lt="collapsed">collapsed flex item</dfn>,
826826
producing an effect similar to ''visibility:collapse'' on a table-row or table-column:
827-
the collapsed flex item is removed from rendering entirely,
827+
the [=collapsed flex item=] is removed from rendering entirely,
828828
but leaves behind a "strut" that keeps the flex line's cross-size stable.
829829
Thus, if a flex container has only one flex line,
830830
dynamically collapsing or uncollapsing items
@@ -834,7 +834,7 @@ Collapsed Items</h3>
834834
Flex line wrapping <em>is</em> re-done after collapsing, however,
835835
so the cross-size of a flex container with multiple lines might or might not change.
836836

837-
Though collapsed flex items aren't rendered,
837+
Though [=collapsed flex items=] aren't rendered,
838838
they do appear in the <a href="https://www.w3.org/TR/CSS2/intro.html#formatting-structure">formatting structure</a>.
839839
Therefore, unlike on ''display:none'' items [[!CSS2]],
840840
effects that depend on a box appearing in the formatting structure
@@ -931,7 +931,7 @@ Collapsed Items</h3>
931931
</div>
932932

933933
To compute the size of the strut, flex layout is first performed with all items uncollapsed,
934-
and then re-run with each collapsed item replaced by a strut that maintains
934+
and then re-run with each [=collapsed flex item=] replaced by a strut that maintains
935935
the original cross-size of the item's original line.
936936
See the <a href="#layout-algorithm">Flex Layout Algorithm</a>
937937
for the normative definition of how ''visibility:collapse''
@@ -1634,7 +1634,7 @@ The 'flex' Shorthand</h3>
16341634
Animation type: by computed value type
16351635
</pre>
16361636

1637-
The 'flex' property specifies the components of a <dfn>flexible length</dfn>:
1637+
The 'flex' property specifies the components of a flexible size:
16381638
the <dfn lt="flex factor">flex factors</dfn>
16391639
(<a lt="flex grow factor">grow</a> and <a lt="flex shrink factor">shrink</a>)
16401640
and the <a>flex basis</a>.
@@ -2721,24 +2721,22 @@ Cross Size Determination</h3>
27212721
<li id='algo-visibility'>
27222722
<strong>Collapse ''visibility:collapse'' items.</strong>
27232723
If any flex items have ''visibility: collapse'',
2724-
note the cross size of the line they're in as the item's <dfn>strut size</dfn>,
2724+
note the cross size of the line they're in as the item's |strut size|,
27252725
and restart layout from the beginning.
27262726

2727-
<p>
2728-
In this second layout round,
2729-
when <a href="#algo-line-break">collecting items into lines</a>,
2730-
treat the collapsed items as having zero <a>main size</a>.
2731-
For the rest of the algorithm following that step,
2732-
ignore the collapsed items entirely
2733-
(as if they were ''display:none'')
2734-
except that after <a href="#algo-cross-line">calculating the cross size of the lines</a>,
2735-
if any line's cross size is less than
2736-
the largest <var>strut size</var>
2737-
among all the collapsed items in the line,
2738-
set its cross size to that <var>strut size</var>.
2727+
In this second layout round,
2728+
when <a href="#algo-line-break">collecting items into lines</a>,
2729+
treat the collapsed items as having zero <a>main size</a>.
2730+
For the rest of the algorithm following that step,
2731+
ignore the collapsed items entirely
2732+
(as if they were ''display:none'')
2733+
except that after <a href="#algo-cross-line">calculating the cross size of the lines</a>,
2734+
if any line's cross size is less than
2735+
the largest <var>strut size</var>
2736+
among all the collapsed items in the line,
2737+
set its cross size to that <var>strut size</var>.
27392738

2740-
<p>
2741-
Skip this step in the second layout round.
2739+
Skip this step in the second layout round.
27422740

27432741
<li id='algo-stretch'>
27442742
<strong>Determine the used cross size of each flex item.</strong>
@@ -3702,7 +3700,7 @@ Changes since the <a href="https://www.w3.org/TR/2018/CR-css-flexbox-1-20181119/
37023700

37033701
<ul>
37043702
<li id="change-2019-bracket-range-notation">
3705-
Changed syntax to use <a>bracketed range notation</a> to reflect the prose restrictions on negative values.
3703+
Changed syntax to use <a>CSS bracketed range notation</a> to reflect the prose restrictions on negative values.
37063704

37073705
<li id="change-2018-used-cross-size">
37083706
Clarified that the [=flex base size=] calculations
@@ -3723,7 +3721,7 @@ Changes since the <a href="https://www.w3.org/TR/2018/CR-css-flexbox-1-20181119/
37233721
(<a href="https://github.com/w3c/csswg-drafts/issues/5188">Issue 5188</a>)
37243722

37253723
<blockquote>
3726-
<p><strong>Determine the <dfn>hypothetical cross size</dfn> of each item</strong>
3724+
<p><strong>Determine the hypothetical cross size of each item</strong>
37273725
by performing layout <ins>as if it were an [=in-flow=] [=block-level box=]
37283726
with the used <a>main size</a> and the <ins>given</ins> available space &hellip;
37293727
</blockquote>
@@ -4935,7 +4933,7 @@ Substantive Changes and Bugfixes</h4>
49354933
<li id="change-2012-min-width">
49364934
Changed the behavior of the new ''min-width/auto'' initial value of 'min-width'/'min-height' to
49374935
<ul>
4938-
<li>Take into account whether 'overflow' is ''visible'',
4936+
<li>Take into account whether 'overflow' is ''overflow/visible'',
49394937
since when 'overflow' is explicitly handled, it is confusing (and unnecessary)
49404938
to force enough size to show all the content.
49414939
<li>Take into account the specified 'width'/'height',

0 commit comments

Comments
 (0)