Skip to content

Commit a176be2

Browse files
committed
[css-flexbox] Better paragraphing in section 4
--HG-- extra : rebase_source : 5da97322799546312158dfc3dbae550193f5fda8
1 parent 9209012 commit a176be2

2 files changed

Lines changed: 30 additions & 26 deletions

File tree

css-flexbox/Overview.bs

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -548,26 +548,13 @@ Flex Items</h2>
548548
(i.e. characters that can be affected by the 'white-space' property)
549549
is not rendered, as if it were ''display:none''.
550550

551-
<p class="note">
552-
Authors reading this spec may want to
553-
<a href="#item-margins">skip past these box-generation details</a>.
554-
555551
<p>
556552
A <i>flex item</i> establishes a new formatting context for its contents.
557553
The type of this formatting context is determined by its 'display' value, as usual.
558-
The computed 'display' of a <i>flex item</i>
559-
is determined by applying the table in
560-
<a href="http://www.w3.org/TR/CSS2/visuren.html#dis-pos-flo">CSS 2.1 Chapter 9.7</a>
561-
(except that internal table boxes are instead handled by anonymous box fixup, see below).
562554
However, flex items are flex-level boxes, not block-level boxes:
563555
they participate in their container's flex formatting context,
564556
not in a block formatting context.
565557

566-
<p class='note'>
567-
The 'display' computation on flex items as defined here
568-
is expected to be superseded by a future specification
569-
that defines a new 'display' value specific to flex items.
570-
571558
<div class="example">
572559
<p>Examples of flex items:
573560
<pre>
@@ -592,6 +579,21 @@ Flex Items</h2>
592579
&lt;/div></pre>
593580
</div>
594581

582+
<p class="note">
583+
Authors reading this spec may want to
584+
<a href="#item-margins">skip past the following box-generation details</a>.
585+
586+
<p>
587+
The computed 'display' of a <i>flex item</i>
588+
is determined by applying the table in
589+
<a href="http://www.w3.org/TR/CSS2/visuren.html#dis-pos-flo">CSS 2.1 Chapter 9.7</a>
590+
(except that internal table boxes are instead handled by anonymous box fixup, see below).
591+
592+
<p class='note'>
593+
The 'display' computation on flex items as defined here
594+
is expected to be superseded by a future specification
595+
that defines a new 'display' value specific to flex items.
596+
595597
<p>
596598
Some values of 'display' trigger the generation of anonymous boxes.
597599
For example, a misparented ''table-cell'' child is fixed up

css-flexbox/Overview.html

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -694,26 +694,13 @@ <h2 class="heading settled heading" data-level=4 id=flex-items><span class=secno
694694
(i.e. characters that can be affected by the <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-text-3/#white-space title=white-space>white-space</a> property)
695695
is not rendered, as if it were <a class=css data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display:none</a>.
696696

697-
<p class=note>
698-
Authors reading this spec may want to
699-
<a href=#item-margins>skip past these box-generation details</a>.
700-
701697
<p>
702698
A <a data-link-type=dfn href=#flex-item title="flex item">flex item</a> establishes a new formatting context for its contents.
703699
The type of this formatting context is determined by its <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display</a> value, as usual.
704-
The computed <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display</a> of a <a data-link-type=dfn href=#flex-item title="flex item">flex item</a>
705-
is determined by applying the table in
706-
<a href=http://www.w3.org/TR/CSS2/visuren.html#dis-pos-flo>CSS 2.1 Chapter 9.7</a>
707-
(except that internal table boxes are instead handled by anonymous box fixup, see below).
708700
However, flex items are flex-level boxes, not block-level boxes:
709701
they participate in their container’s flex formatting context,
710702
not in a block formatting context.
711703

712-
<p class=note>
713-
The <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display</a> computation on flex items as defined here
714-
is expected to be superseded by a future specification
715-
that defines a new <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display</a> value specific to flex items.
716-
717704
<div class=example>
718705
<p>Examples of flex items:
719706
<pre>&lt;div style="display:flex"&gt;
@@ -736,6 +723,21 @@ <h2 class="heading settled heading" data-level=4 id=flex-items><span class=secno
736723
&lt;/span&gt;
737724
&lt;/div&gt;</pre> </div>
738725

726+
<p class=note>
727+
Authors reading this spec may want to
728+
<a href=#item-margins>skip past the following box-generation details</a>.
729+
730+
<p>
731+
The computed <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display</a> of a <a data-link-type=dfn href=#flex-item title="flex item">flex item</a>
732+
is determined by applying the table in
733+
<a href=http://www.w3.org/TR/CSS2/visuren.html#dis-pos-flo>CSS 2.1 Chapter 9.7</a>
734+
(except that internal table boxes are instead handled by anonymous box fixup, see below).
735+
736+
<p class=note>
737+
The <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display</a> computation on flex items as defined here
738+
is expected to be superseded by a future specification
739+
that defines a new <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display</a> value specific to flex items.
740+
739741
<p>
740742
Some values of <a class=property data-link-type=propdesc href=http://www.w3.org/TR/CSS21/visuren.html#propdef-display title=display>display</a> trigger the generation of anonymous boxes.
741743
For example, a misparented <span class=css data-link-type=maybe title=table-cell>table-cell</span> child is fixed up

0 commit comments

Comments
 (0)