Skip to content

Commit 21f3c75

Browse files
committed
[css-break] Fold in some clarifications. Make monolithic elements respect 'slice to avoid overflow' rule.
1 parent ae90b52 commit 21f3c75

2 files changed

Lines changed: 42 additions & 68 deletions

File tree

css-break/Overview.html

Lines changed: 27 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
rel=dcterms.rights>
1414
<meta content="CSS Fragmentation Module Level 3" name=dcterms.title>
1515
<meta content=text name=dcterms.type>
16-
<meta content=2015-01-19 name=dcterms.date>
16+
<meta content=2015-01-20 name=dcterms.date>
1717
<meta content="Rossen Atanassov" name=dcterms.creator>
1818
<meta content="Microsoft Corporation" name=dcterms.creator>
1919
<meta
@@ -26,7 +26,7 @@
2626
<link href="../default.css" rel=stylesheet type="text/css">
2727
<link href="http://www.w3.org/StyleSheets/TR/W3C-ED.css" rel=stylesheet
2828
type="text/css">
29-
<style>
29+
<style type=css>
3030
.css::before, .css::after, .property::before, .property::after { content: none !important;}
3131
</style>
3232

@@ -40,7 +40,7 @@ <h1 id=css-fragmentation-module>CSS Fragmentation Module Level 3</h1>
4040
<h2 class="no-num no-toc" id=subtitle>Breaking the Web, one fragment at a
4141
time</h2>
4242

43-
<h2 class="no-num no-toc">Editor's Draft 19 January 2015</h2>
43+
<h2 class="no-num no-toc">Editor's Draft 20 January 2015</h2>
4444

4545
<dl>
4646
<dt>This version:
@@ -371,8 +371,11 @@ <h2 id=fragmentation-model><span class=secno>2. </span> Fragmentation Model
371371
chain of <a href="http://www.w3.org/TR/css3-regions">CSS regions</a>, or
372372
a <a href="http://www.w3.org/TR/css3-page/">paged media display</a>. A
373373
given fragmentation context can only have one block flow direction across
374-
all its <a href="#fragmentainer"><i>fragmentainers</i></a>.
375-
<!-- XXX clarify that multiple writing modes are allowed, just fragmentationis in one direction -->
374+
all its <a href="#fragmentainer"><i>fragmentainers</i></a>. (Descendants
375+
of the <a href="#fragmentation-root"><i>fragmentation root</i></a> may
376+
have other block flow directions, but fragmentation proceeds according to
377+
the block flow direction applied to the <a
378+
href="#fragmentation-root"><i>fragmentation root</i></a>.)
376379

377380
<dt><dfn id=fragmented-flow>fragmented flow</dfn>
378381

@@ -458,11 +461,12 @@ <h3 id=parallel-flows><span class=secno>2.1. </span> Parallel Fragmentation
458461
</ul>
459462

460463
<p> Content overflowing the content edge of a fixed-size box is considered
461-
parallel to the content after the fixed-size box. Such content fragments
462-
within the context of the box's <a href="#fragmented-flow"><i>fragmented
463-
flow</i></a> following normal fragmentation rules, increasing the length
464-
of the <a href="#fragmented-flow"><i>fragmented flow</i></a> as necessary.
465-
<!-- XXX this paragraph is generally confusing -->
464+
parallel to the content after the fixed-size box and follows the normal
465+
fragmentation rules. Although overflowing content doesn't affect the size
466+
of the <a href="#fragmentation-root"><i>fragmentation root</i></a> box, it
467+
does increase the length of the <a href="#fragmented-flow"><i>fragmented
468+
flow</i></a>, spilling into or generating additional <a
469+
href="#fragmentainer"><i>fragmentainers</i></a> as necessary.
466470

467471
<h3 id=nested-flows><span class=secno>2.2. </span> Nested Fragmentation
468472
Flows</h3>
@@ -938,10 +942,11 @@ <h3 id=possible-breaks><span class=secno>4.1. </span> Possible Break Points</h3>
938942
<dt>Block-parallel Fragmentation
939943

940944
<dd> When the block flow direction of the siblings' containing block is
941-
parallel to that of the fragmentation context: in-flow block-level
942-
boxes, <!-- XXX linkify in-flow --> a float and an immediately-adjacent
943-
in-flow or floated box, table row group boxes, table row boxes,
944-
multi-column column row boxes.
945+
parallel to that of the fragmentation context: <a
946+
href="http://www.w3.org/TR/2011/REC-CSS2-20110607/visuren.html#positioning-scheme">in-flow</a>
947+
block-level boxes, a float and an immediately-adjacent in-flow or
948+
floated box, table row group boxes, table row boxes, multi-column
949+
column row boxes.
945950

946951
<dt>Block-perpendicular Fragmentation
947952

@@ -965,13 +970,12 @@ <h3 id=possible-breaks><span class=secno>4.1. </span> Possible Break Points</h3>
965970
<p class=note> There is no inherent prioritization among these classes of
966971
break points. However, individual break points may be prioritized or
967972
de-prioritized by using the <a href="#breaking-controls">breaking
968-
controls</a>. <!-- XXX fix this, it's inconsistent -->
973+
controls</a>.
969974

970975
<p id=monolithic-breaking> The UA is not required to fragment the contents
971976
of <a href="#monolithic"><i>monolithic</i></a> elements, and may instead
972977
either slice the element's graphical representation as necessary to
973-
fragment it or treat its box as unbreakable and overflow the
974-
fragmentainer. In both cases it must treat the element as having ‘<code
978+
fragment it. In this case it must treat the element as having ‘<code
975979
class=css>break-inside: avoid</code>’, i.e. only slice or overflow at
976980
the fragmentainer edge if there are no other <a
977981
href="#possible-breaks">possible break points</a> in the fragmentainer.
@@ -1753,38 +1757,17 @@ <h3 id=cr-exit-criteria><span class=secno>6.6. </span> CR Exit Criteria</h3>
17531757
<h2 class=no-num id=changes> Changes</h2>
17541758

17551759
<p>The following significant changes were made since the <a
1756-
href="http://www.w3.org/TR/2012/WD-css3-break-20120823/">29 August 2012
1760+
href="http://www.w3.org/TR/2014/WD-css3-break-20140116/">16 January 2014
17571761
Working Draft</a>:
17581762

17591763
<ul>
1760-
<li>Added definition of ‘<a href="#box-decoration-break"><code
1761-
class=property>box-decoration-break</code></a>’ (moved from <a
1762-
href="#ref-CSS3BG" rel=biblioentry>[CSS3BG]<!--{{CSS3BG}}--></a>) and
1763-
defined better handling of aspect-ratio-sized images in variable-sized
1764-
fragments.
1764+
<li>Clarified behavior of fragmented transformed overflow.
17651765

1766-
<li>Added ‘<a href="#any"><code class=css>any</code></a>’ value to
1767-
<a href="#break-before"><code
1768-
class=property>break-before</code></a>’ and ‘<a
1769-
href="#break-after"><code class=property>break-after</code></a>’.
1766+
<li>Clarified the behavior of fragmented ‘<code
1767+
class=property>border-radius</code>’ curves.
17701768

1771-
<li>Defined that boxes <a href="#box-splitting">extend to the bottom of
1772-
the page</a> when broken.
1773-
1774-
<li>Defined breaking of <a href="#transforms">transformed/positioned
1775-
content</a>.
1776-
1777-
<li>Defined 1px minimum extent of fragmentainers to ensure progress.
1778-
1779-
<li>Clarified fragmentation of <a href="#parallel-flows">parallel
1780-
flows</a>.
1781-
1782-
<li>Defined handling of overflowing content (as parallel content).
1783-
1784-
<li>Clarified <a href="#varying-size-boxes">float fragmentation</a> in
1785-
varying-size fragmentainers.
1786-
1787-
<li>Various other clarifications.
1769+
<li>Generalized "break anywhere to avoid overflow" rule to all
1770+
fragmentation types.
17881771
</ul>
17891772

17901773
<h2 class=no-num id=acknowledgments> Acknowledgments</h2>

css-break/Overview.src.html

Lines changed: 15 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
<title>CSS Fragmentation Module Level 3</title>
88
<link rel="stylesheet" type="text/css" href="../default.css">
99
<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-ED.css">
10-
<style>
10+
<style type=css>
1111
.css::before, .css::after, .property::before, .property::after { content: none !important;}
1212
</style>
1313
</head>
@@ -148,7 +148,8 @@ <h2 id="fragmentation-model">
148148
or a <a href="http://www.w3.org/TR/css3-page/">paged media display</a>.
149149
A given fragmentation context can only have one block flow direction
150150
across all its <i>fragmentainers</i>.
151-
<!-- XXX clarify that multiple writing modes are allowed, just fragmentationis in one direction -->
151+
(Descendants of the <i>fragmentation root</i> may have other block flow directions,
152+
but fragmentation proceeds according to the block flow direction applied to the <i>fragmentation root</i>.)
152153
</dd>
153154
<dt><dfn>fragmented flow</dfn></dt>
154155
<dd>
@@ -223,11 +224,11 @@ <h3 id="parallel-flows">
223224

224225
<p>
225226
Content overflowing the content edge of a fixed-size box
226-
is considered parallel to the content after the fixed-size box.
227-
Such content fragments within the context of the box's <i>fragmented flow</i>
228-
following normal fragmentation rules,
229-
increasing the length of the <i>fragmented flow</i> as necessary.
230-
<!-- XXX this paragraph is generally confusing -->
227+
is considered parallel to the content after the fixed-size box
228+
and follows the normal fragmentation rules.
229+
Although overflowing content doesn't affect the size of the <i>fragmentation root</i> box,
230+
it does increase the length of the <i>fragmented flow</i>,
231+
spilling into or generating additional <i>fragmentainers</i> as necessary.
231232
</p>
232233

233234
<h3 id="nested-flows">
@@ -626,7 +627,7 @@ <h3 id="possible-breaks">
626627
<dd>
627628
When the block flow direction of the siblings' containing block
628629
is parallel to that of the fragmentation context:
629-
in-flow block-level boxes, <!-- XXX linkify in-flow -->
630+
<a href="http://www.w3.org/TR/2011/REC-CSS2-20110607/visuren.html#positioning-scheme">in-flow</a> block-level boxes,
630631
a float and an immediately-adjacent in-flow or floated box,
631632
table row group boxes,
632633
table row boxes,
@@ -660,14 +661,11 @@ <h3 id="possible-breaks">
660661
However, individual break points may be prioritized or de-prioritized
661662
by using the <a href="#breaking-controls">breaking controls</a>.
662663

663-
<!-- XXX fix this, it's inconsistent -->
664-
665664
<p id=monolithic-breaking>
666665
The UA is not required to fragment the contents of <i>monolithic</i> elements,
667666
and may instead either slice the element's graphical representation
668-
as necessary to fragment it
669-
or treat its box as unbreakable and overflow the fragmentainer.
670-
In both cases it must treat the element as having ''break-inside: avoid'',
667+
as necessary to fragment it.
668+
In this case it must treat the element as having ''break-inside: avoid'',
671669
i.e. only slice or overflow at the fragmentainer edge
672670
if there are no other <a href="#possible-breaks">possible break points</a>
673671
in the fragmentainer.
@@ -1417,19 +1415,12 @@ <h2 class="no-num" id="changes">
14171415
Changes</h2>
14181416

14191417
<p>The following significant changes were made since the
1420-
<a href="http://www.w3.org/TR/2012/WD-css3-break-20120823/">29 August 2012 Working Draft</a>:
1418+
<a href="http://www.w3.org/TR/2014/WD-css3-break-20140116/">16 January 2014 Working Draft</a>:
14211419

14221420
<ul>
1423-
<li>Added definition of 'box-decoration-break' (moved from [[CSS3BG]])
1424-
and defined better handling of aspect-ratio-sized images in variable-sized fragments.
1425-
<li>Added ''any'' value to 'break-before' and 'break-after'.
1426-
<li>Defined that boxes <a href="#box-splitting">extend to the bottom of the page</a> when broken.
1427-
<li>Defined breaking of <a href="#transforms">transformed/positioned content</a>.
1428-
<li>Defined 1px minimum extent of fragmentainers to ensure progress.
1429-
<li>Clarified fragmentation of <a href="#parallel-flows">parallel flows</a>.
1430-
<li>Defined handling of overflowing content (as parallel content).
1431-
<li>Clarified <a href="#varying-size-boxes">float fragmentation</a> in varying-size fragmentainers.
1432-
<li>Various other clarifications.
1421+
<li>Clarified behavior of fragmented transformed overflow.
1422+
<li>Clarified the behavior of fragmented 'border-radius' curves.
1423+
<li>Generalized "break anywhere to avoid overflow" rule to all fragmentation types.
14331424
</ul>
14341425

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

0 commit comments

Comments
 (0)