Skip to content

Commit ee7589e

Browse files
committed
[css-multicol] Defer the definition of break-* to css3-break
1 parent f0f08c8 commit ee7589e

2 files changed

Lines changed: 403 additions & 2744 deletions

File tree

css-multicol/Overview.bs

Lines changed: 3 additions & 114 deletions
Original file line numberDiff line numberDiff line change
@@ -901,125 +901,14 @@ Column breaks</h2>
901901

902902
Three new properties are introduced to allow column breaks to be
903903
described in the same properties as page breaks: 'break-before',
904-
'break-after', and 'break-inside'. These properties take the same
905-
values as 'page-break-before', 'page-break-after', and
906-
'page-break-inside' [[!CSS21]]. In addition, some new keyword values
907-
are added.
904+
'break-after', and 'break-inside'.
908905

909906

910907
<h3 id="break-before-break-after-break-inside">
911908
'break-before', 'break-after', 'break-inside'</h3>
912909

913-
<div noexport>
914-
<pre class="propdef">
915-
Name: break-before
916-
Value: auto | always | avoid | left | right | page | column | avoid-page | avoid-column
917-
Initial: auto
918-
Applies to: block-level elements
919-
Inherited: no
920-
Percentages: N/A
921-
Media: visual
922-
Computed value: specified value
923-
</pre>
924-
925-
<pre class="propdef">
926-
Name: break-after
927-
Value: auto | always | avoid | left | right | page | column | avoid-page | avoid-column
928-
Initial: auto
929-
Applies to: block-level elements
930-
Inherited: no
931-
Percentages: N/A
932-
Media: visual
933-
Computed value: specified value
934-
</pre>
935-
936-
<pre class="propdef">
937-
Name: break-inside
938-
Value: auto | avoid | avoid-page | avoid-column
939-
Initial: auto
940-
Applies to: block-level elements
941-
Inherited: no
942-
Percentages: N/A
943-
Media: visual
944-
Computed value: specified value
945-
</pre>
946-
</div>
947-
948-
These properties describe page/column break behavior before/after/inside the generated box. These values are normatively defined in [[!CSS21]]:
949-
950-
<dl dfn-type=value dfn-for="break-before, break-after, break-inside">
951-
<dt><dfn>auto</dfn>
952-
<dd>
953-
Neither force nor forbid a page/column break before (after, inside) the generated box.
954-
955-
<dt><dfn>always</dfn>
956-
<dd>
957-
Always force a page break before (after) the generated box.
958-
959-
<dt><dfn>avoid</dfn>
960-
<dd>
961-
Avoid a page/column break before (after, inside) the generated box.
962-
963-
<dt><dfn for="break-before, break-after">left</dfn>
964-
<dd>
965-
Force one or two page breaks before (after) the generated box so that the next page is formatted as a left page.
966-
967-
<dt><dfn for="break-before, break-after">right</dfn>
968-
<dd>
969-
Force one or two page breaks before (after) the generated box so that the next page is formatted as a right page.
970-
</dl>
971-
972-
This specification adds the following new values:
973-
974-
<dl dfn-type=value dfn-for="break-before, break-after, break-inside">
975-
<dt><dfn for="break-before, break-after">page</dfn>
976-
<dd>
977-
Always force a page break before (after) the generated box.
978-
979-
<dt><dfn for="break-before, break-after">column</dfn>
980-
<dd>
981-
Always force a column break before (after) the generated box.
982-
983-
<dt><dfn>avoid-page</dfn>
984-
<dd>
985-
Avoid a page break before (after, inside) the generated box.
986-
987-
<dt><dfn>avoid-column</dfn>
988-
<dd>
989-
Avoid a column break before (after, inside) the generated box.
990-
</dl>
991-
992-
When a page or column break splits a box, the box's margins,
993-
borders, and padding have no visual effect where the split occurs.
994-
However, the margin immediately after a forced page/column break will
995-
be preserved. A forced page/column break is a break that does not occur
996-
naturally.
997-
998-
Note: In the future, new properties may describe alternate
999-
ways to handle margins, borders and padding around page/column breaks.
1000-
1001-
<div class="example">
1002-
In this example, forced column breaks appear before <code>h2</code>
1003-
elements and after <code>img</code> elements:
1004-
1005-
<pre>
1006-
.multicol { column-width: 8em }
1007-
.multicol h2 { break-before: column; margin-top: 2em }
1008-
.multicol img { break-after: column }
1009-
</pre>
1010-
1011-
The top margin of <code>h2</code> elements will be preserved since the column break is forced.
1012-
</div>
1013-
1014-
<div class="example">
1015-
In this example, the formatter will try avoid column breaks inside <code>p</code> elements:
1016-
1017-
<pre>
1018-
p { break-inside: avoid-column }
1019-
</pre>
1020-
</div>
1021-
1022-
910+
'break-before', 'break-after', and 'break-inside'
911+
are defined in [[!CSS3-BREAK]].
1023912

1024913
<h2 id="spanning-columns">
1025914
Spanning columns</h2>

0 commit comments

Comments
 (0)