Skip to content

Commit 7886989

Browse files
committed
[css-break-4] Add always/all values to break-before/break-after.
1 parent fc518f3 commit 7886989

File tree

1 file changed

+28
-6
lines changed

1 file changed

+28
-6
lines changed

css-break-4/Overview.bs

Lines changed: 28 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ Abstract: This module describes the fragmentation model that partitions a flow i
1313
Abstract: It builds on the Page model module and introduces and defines the fragmentation model.
1414
Abstract: It adds functionality for pagination, breaking variable fragment size and orientation, widows and orphans.
1515
Ignored Terms: background positioning area, region chain, … message topic …, reference box
16+
At Risk: the ''break-before/all'' value of 'break-before'/'break-after'
1617
</pre>
1718

1819
<h1>CSS Fragmentation Module Level 4 <br> <small>Breaking the Web, one fragment at a time</small></h1>
@@ -46,10 +47,11 @@ Introduction</h2>
4647
and how such breaks can be
4748
<a href="https://www.w3.org/TR/css-break-3/#breaking-controls">controlled by the author</a>.
4849

49-
ISSUE: This is currently a diff spec.
50-
See <a href="https://www.w3.org/TR/css-break-3/">CSS Fragmentation Level 3</a>
51-
for the rest of the specification.
52-
(That text will eventually be folded into this document.)
50+
This specification is identical to
51+
<a href="https://www.w3.org/TR/css-break-3/">CSS Fragmentation Level 3</a>
52+
except for the addition of the 'margin-break' property
53+
and the ''break-before/always'' and ''break-before/all'' values
54+
of the 'break-before' and 'break-after' properties.
5355

5456
<h3 id="placement">
5557
Module Interactions</h3>
@@ -244,7 +246,7 @@ Breaks Between Boxes: the 'break-before' and 'break-after' properties</h3>
244246

245247
<pre class="propdef">
246248
Name: break-before, break-after
247-
Value: auto | avoid | avoid-page | page | left | right | recto | verso | avoid-column | column | avoid-region | region
249+
Value: auto | avoid | always | all | avoid-page | page | left | right | recto | verso | avoid-column | column | avoid-region | region
248250
Initial: auto
249251
Applies to: block-level boxes, grid items, flex items, table row groups, table rows (but see prose)
250252
Inherited: no
@@ -255,7 +257,7 @@ Breaks Between Boxes: the 'break-before' and 'break-after' properties</h3>
255257
These properties specify page/column/region break behavior
256258
before/after the generated box.
257259
The <dfn>forced break values</dfn>
258-
''left'', ''right'', ''recto'', ''verso'', ''page'', ''column'' and ''region''
260+
''always'', ''all'', ''left'', ''right'', ''recto'', ''verso'', ''page'', ''column'' and ''region''
259261
create a <a href="#forced-breaks">forced break</a> in the flow
260262
while the <dfn>avoid break values</dfn>
261263
''break-before/avoid'', ''break-before/avoid-page'', ''break-before/avoid-column'' and ''break-before/avoid-region''
@@ -283,6 +285,25 @@ Generic Break Values</h4>
283285
<dt><dfn>avoid</dfn>
284286
<dd>
285287
Avoid a break before/after the <a href="https://www.w3.org/TR/CSS2/visuren.html#block-boxes">principal box</a>.
288+
289+
<dt><dfn>always</dfn>
290+
<dd>
291+
Always force a break before/after the <a>principal box</a>.
292+
The type of this break is that of the immediately-containing <a>fragmentation context</a>.
293+
For example, in a <a>multi-column container</a> forces a <a>column break</a>;
294+
in <a>paged media</a> not inside a <a>multi-column container</a>,
295+
forces a <a>page break</a>.
296+
297+
<dt><dfn>all</dfn>
298+
<dd>
299+
Always force a break before/after the <a>principal box</a>.
300+
This value breaks through all containing <a>fragmentation contexts</a>.
301+
For example, inside a <a>multi-column container</a> in a <a>region</a> in a <a>multi-column container</a> in <a>paged media</a>,
302+
it forces simultaneously a <a>column break</a> in the inner <a>multi-column container</a>,
303+
a <a>region break</a>, a <a>column break</a> in the outer <a>multi-column container</a>,
304+
and a <a>page break</a>.
305+
306+
Issue: It's unclear if this value is needed.
286307
</dl>
287308

288309
<h4 id="page-break-values" class="no-num">
@@ -1223,6 +1244,7 @@ Changes Since Level 3</h3>
12231244
<a href="https://www.w3.org/TR/css-break-3/">CSS Fragmentation Level 3</a>:
12241245
<ul>
12251246
<li>The 'margin-break' property.
1247+
<li>The ''break-before/always'' and ''break-before/all'' values of 'break-before'/'break-after'.
12261248
</ul>
12271249

12281250
<h2 class="no-num" id="acknowledgments">

0 commit comments

Comments
 (0)