Skip to content

Commit eff256b

Browse files
authored
[css-multicol-2] Initial pass at changes to the model section. (#12544)
Initial pass at changes to the model section. There's more to do and it needs examples, but this helps clarify rows and lines.
1 parent 5f19369 commit eff256b

File tree

1 file changed

+23
-10
lines changed

1 file changed

+23
-10
lines changed

css-multicol-2/Overview.bs

Lines changed: 23 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -360,7 +360,9 @@ The multi-column model</h2>
360360

361361
The column boxes are ordered
362362
in the [=inline base direction=] of the multicol container
363-
and arranged into <dfn lt="multi-column line | multi-col line | multicol line">multicol lines</dfn>.
363+
and arranged into <dfn lt="multi-column row | multi-col row | multicol row">multicol rows</dfn>.
364+
A multicol row contains at least one <dfn lt="multi-column line | multi-col line | multicol line">multicol line</dfn>
365+
or spanning element.
364366
The <dfn export>column width</dfn> is the length of the column box in the inline direction.
365367
The <dfn export>column height</dfn> is the length of the column box in the block direction.
366368
All column boxes in a line have the same column width,
@@ -529,28 +531,36 @@ The multi-column model</h2>
529531
hit-test-in-vertical-rl.html
530532
</wpt>
531533

532-
Within each [=multicol line=] in the multi-column container,
534+
In the inline direction, within each [=multicol line=] in the multi-column container,
533535
adjacent column boxes are separated by a <dfn noexport>column gap</dfn>,
534536
which may contain a <dfn noexport>column rule</dfn>.
537+
In the block direction, [=column rows=] are separated by a <dfn noexport>row gap</dfn>,
538+
which may contain a <dfn noexport>row rule</dfn>.
535539
All column gaps in the same multi-column container are equal.
536540
All column rules in the same multi-column container are also equal, if they appear;
537541
column rules only appear between columns that both have content.
538542

539-
In the simplest case a multicol container will contain only one line
540-
of columns, and the height of each column will be equivalent to the
543+
In the simplest case a multicol container will contain only one line of columns,
544+
inside one multicol row, and the height of each column will be equivalent to the
541545
used height of the multi-column container's content box.
542546
However, [=fragmentation=] or [=spanners=]
543-
can split the content of the [=multi-column container=]
547+
can split the content of the [=multicol row=]
544548
into multiple [=multicol lines=].
545549

546550
If the multi-column container is paginated, the height of each column is
547551
constrained by the page and the content continues in a new line of
548552
column boxes on the next page; a column box never splits across pages.
549553

550-
The same effect occurs when a <i>spanning element</i> divides the
551-
multi-column container: the columns before the spanning element are
554+
If a multi-column container in continuous media is set to wrap,
555+
the height of each column is defined by the 'column-height' property.
556+
If there is more content than will fit in a single row a new multicol row is created
557+
in the block direction, with columns of the size defined by the 'column-height' property.
558+
559+
When a <i>spanning element</i> divides the
560+
multi-column container: a new multicol line is created.
561+
The columns before the spanning element are
552562
balanced and shortened to fit their content. Content after the
553-
spanning element then flows into a new, subsequent line of column boxes.
563+
spanning element then flows into a new, subsequent multicol line of column boxes.
554564

555565
<div class="example">
556566
<figure>
@@ -559,10 +569,13 @@ The multi-column model</h2>
559569
</figure>
560570
</div>
561571

572+
Issue(11976): This issue deals with the scenario where there is not enough space
573+
in the current multicol row for a spanning element. Once resolved, add details here.
574+
562575
A [=multi-column container=] therefore is a regular [=block container=]
563576
that establishes a new [=independent formatting context=]
564-
whose contents consist of a series of
565-
[=multicol lines=] and multicol spanners.
577+
whose contents consist of one or more
578+
[=multicol rows=], containing [=multicol lines=] and multicol spanners.
566579
Each [=multi-column line=] acts as a [=block-level box=]
567580
that establishes a <dfn>multi-column formatting context</dfn>
568581
for its [=column boxes=];

0 commit comments

Comments
 (0)