Skip to content

Commit cae358e

Browse files
committed
[css-flexbox] Reword main/cross size dfns. Make it clearer that any reference to used width/height refers to the flexed size.
1 parent 88fb371 commit cae358e

1 file changed

Lines changed: 23 additions & 16 deletions

File tree

css-flexbox-1/Overview.bs

Lines changed: 23 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -473,17 +473,24 @@ Flex Layout Box Model and Terminology</h2>
473473
<dt class='size'>main size
474474
<dt class='size'>main size property
475475
<dd>
476-
The width or height of a <a>flex container</a> or <a>flex item</a>,
477-
whichever is in the <a>main dimension</a>,
478-
is that box’s <dfn lt="main size|main-size">main size</dfn>.
479-
Its <dfn>main size property</dfn> is
480-
thus either its 'width' or 'height' property,
481-
whichever is in the <a>main dimension</a>.
482-
Similarly, its <dfn lt="min main size property">min</dfn> and
476+
The <dfn>main size</dfn> of a [=flex container=] or [=flex item=]
477+
refers to its [=width=] or [=height=],
478+
whichever is in the [=main dimension=].
479+
Its <dfn>main size property</dfn>
480+
is either its 'width' or 'height' property,
481+
whichever is in the [=main dimension=].
482+
Likewise, its <dfn lt="min main size property">min</dfn> and
483483
<dfn lt="max main size property">max main size properties</dfn>
484484
are its 'min-width'/'max-width' or 'min-height'/'max-height' properties,
485-
whichever is in the <a>main dimension</a>,
485+
whichever are in the <a>main dimension</a>,
486486
and determine its <dfn lt="min main size">min</dfn>/<dfn>max main size</dfn>.
487+
488+
In [=flex layout=], the [=main size=] is controlled by the 'flex' property
489+
rather than directly by the [=main size property=].
490+
491+
Note: This means any references to a flex item's used size in the [=main dimension=]
492+
([=width=], [=height=], [=inline size=], [=block size=])
493+
refers to its post-flexing [=main size=].
487494
</dl>
488495

489496
<dl id="cross" export>
@@ -503,16 +510,16 @@ Flex Layout Box Model and Terminology</h2>
503510
<dt class='size'>cross size
504511
<dt class='size'>cross size property
505512
<dd>
506-
The width or height of a <a>flex container</a> or <a>flex item</a>,
507-
whichever is in the <a>cross dimension</a>,
508-
is that box’s <dfn lt="cross size | cross-size">cross size</dfn>.
509-
Its <dfn>cross size property</dfn> is
510-
thus either its 'width' or 'height' property,
511-
whichever is in the <a>cross dimension</a>.
512-
Similarly, its <dfn lt="min cross size property">min</dfn> and
513+
The <dfn>cross size</dfn> of a [=flex container=] or [=flex item=]
514+
refers to its [=width=] or [=height=],
515+
whichever is in the [=cross dimension=].
516+
Its <dfn>cross size property</dfn>
517+
is either its 'width' or 'height' property,
518+
whichever is in the [=cross dimension=].
519+
Likewise, its <dfn lt="min cross size property">min</dfn> and
513520
<dfn lt="max cross size property">max cross size properties</dfn>
514521
are its 'min-width'/'max-width' or 'min-height'/'max-height' properties,
515-
whichever is in the <a>cross dimension</a>,
522+
whichever are in the <a>cross dimension</a>,
516523
and determine its <dfn lt="min cross size">min</dfn>/<dfn>max cross size</dfn>.
517524
</dl>
518525

0 commit comments

Comments
 (0)