Skip to content

Commit 0491ff5

Browse files
committed
[css-break-3][css-break-4][editorial] Fixed Bikeshed errors
1 parent d0bbc17 commit 0491ff5

File tree

2 files changed

+73
-83
lines changed

2 files changed

+73
-83
lines changed

css-break-3/Overview.bs

Lines changed: 25 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,13 @@ Ignored Terms: background positioning area, region chain, … message topic …,
1717
At Risk: the ''region'' and ''break-after/avoid-region'' values of 'break-*'
1818
</pre>
1919

20+
<pre class=link-defaults>
21+
spec:css-borders-4;
22+
type:property; text:border-image
23+
type:property; text:border-radius
24+
type:property; text:box-shadow
25+
</pre>
26+
2027
<h1>CSS Fragmentation Module Level 3 <br> <small>Breaking the Web, one fragment at a time</small></h1>
2128

2229
<h2 id="intro">
@@ -27,8 +34,8 @@ Introduction</h2>
2734
<p>
2835
In [=paged media=] (e.g., paper, transparencies, photo album pages, pages
2936
displayed on computer screens as printed output simulations), as
30-
opposed to [=continuous media=],
31-
the content of the document is split into one or
37+
opposed to [=continuous media=],
38+
the content of the document is split into one or
3239
more discrete display surfaces. In order to avoid awkward breaks
3340
(such as halfway through a line of text), the layout engine must be
3441
able to shift around content that would fall across the page break.
@@ -536,8 +543,8 @@ Rules for Breaking</h2>
536543
</p>
537544

538545
<p>
539-
To guarantee progress, fragmentainers are assumed to have a minimum
540-
<a>block size</a> of 1px regardless of their used size.
546+
To guarantee progress, fragmentainers are assumed to have a minimum
547+
<a>block size</a> of 1px regardless of their used size.
541548

542549
<h3 id="possible-breaks">
543550
Possible Break Points</h3>
@@ -766,7 +773,7 @@ Unforced Breaks</h3>
766773
Finally, if there are no possible break points below the top of the fragmentainer,
767774
and not all the content fits, the UA may break anywhere
768775
in order to avoid losing content off the edge of the fragmentainer.
769-
<span id="monolithic-breaking">
776+
<span id="monolithic-breaking"></span>
770777
In such cases, the UA may also fragment the contents of <a>monolithic</a> elements
771778
by slicing the element's graphical representation.
772779
However, the UA must not break at the top of the page,
@@ -888,6 +895,7 @@ Breaking into Varying-size Fragmentainers</h3>
888895
with the box's margin in addition to its padding and border.
889896
<div class="figure">
890897
<p><img src="images/Varying-Size-Fragmentainers.svg"
898+
width="576"
891899
style="width: 75%"
892900
alt="Illustration: Breaking in varying-size fragmentainers" >
893901
<p class="caption">
@@ -995,8 +1003,9 @@ Splitting Boxes</h3>
9951003

9961004
<div class="figure">
9971005
<p><img
998-
style="width: 80%"
9991006
src="images/Remaining-Fragmentainer-Extent.svg"
1007+
width="300"
1008+
style="width: 80%"
10001009
alt="Illustration: Filling remaining fragmentainer extent">
10011010
<p class="caption">
10021011
Illustration of filling the <a>remaining fragmentainer extent</a>.
@@ -1059,10 +1068,13 @@ Fragmented Borders and Backgrounds: the 'box-decoration-break' property</h3>
10591068
</dl>
10601069

10611070
<div class="figure">
1062-
<p><img alt="Illustration:
1063-
(1) a single box cut in two in between two lines of text by a page break and
1064-
(2) two boxes, one before and one after the page break,
1065-
both with a border all around and their own background image" src="images/box-break.png">
1071+
<p><img
1072+
src="images/box-break.png"
1073+
alt="Illustration:
1074+
(1) a single box cut in two in between two lines of text by a page break and
1075+
(2) two boxes, one before and one after the page break,
1076+
both with a border all around and their own background image"
1077+
width="450">
10661078

10671079
<p class=caption>Two possibilities for 'box-decoration-break':
10681080
on the left, the value ''slice'', on the right the value ''clone''.
@@ -1171,7 +1183,8 @@ Transforms, Positioning, and Pagination</h3>
11711183

11721184
<div class="figure">
11731185
<p><img alt="Illustration: Transformed overflow fragmentation"
1174-
src="images/fragmented-transforms.png">
1186+
src="images/fragmented-transforms.png"
1187+
width="144">
11751188
<p class=caption>A fixed-height box spanning 2.5 pages with overflow content spanning
11761189
to a total of 4 pages.
11771190
The transform origin of each fragment is the center of its border box;
@@ -1238,7 +1251,7 @@ Changes</h2>
12381251
(<a href="https://github.com/w3c/csswg-drafts/issues/3073">Issue 3073</a>)
12391252
<blockquote>
12401253
<p>
1241-
When an unforced break occurs <del>between</del> <ins>before or after a</a> block-level box<del>es</del>,
1254+
When an unforced break occurs <del>between</del> <ins>before or after a</ins> block-level box<del>es</del>,
12421255
any margins adjoining the break <del>truncate to the <a>remaining fragmentainer extent</a> before the break,
12431256
and</del> are truncated to zero <del>after the break</del>.
12441257
</p>
@@ -1314,48 +1327,3 @@ Changes</h2>
13141327
<li id="change-2017-trivial">
13151328
Made a handful of trivial wording fixes.
13161329
</ul>
1317-
1318-
<p>A <a href="https://drafts.csswg.org/css-break-3/issues-cr-2016">Disposition of Comments</a> is available.
1319-
1320-
<p>The following significant changes were made since the
1321-
<a href="https://www.w3.org/TR/2015/WD-css3-break-20150129/">29 January 2015 Working Draft</a>:
1322-
1323-
<ul>
1324-
<li>Dropped <css>any</css> and <css>always</css> values of 'break-*'.
1325-
<li>Switched priority of 'widows' and 'orphans' vs. 'break-*' restrictions
1326-
to make 'widows' and 'orphans' lower-priority rather than higher-priority.
1327-
<li>Defined that margins are also cloned for ''box-decoration-break: clone''
1328-
(but are truncated in block-level layout).
1329-
<li>Corrected unforced breaking rules (Class A) to handle new break types
1330-
(original rules only handled page breaks).
1331-
<li>Allowed dropping cloned box decorations when running out of room.
1332-
</ul>
1333-
1334-
<p>A <a href="https://drafts.csswg.org/css-break-3/issues-lc-2015">Disposition of Comments</a> is available.
1335-
1336-
<h2 class="no-num" id="acknowledgments">
1337-
Acknowledgments</h2>
1338-
1339-
<p>
1340-
The editors would like to thank
1341-
Mihai Balan,
1342-
Michael Day,
1343-
Alex Mogilevsky,
1344-
Shinyu Murakami,
1345-
Florian Rivoal,
1346-
and Alan Stearns
1347-
for their contributions to this module.
1348-
Special thanks go to the former [[CSS3PAGE]] editors
1349-
Jim Bigelow (HP),
1350-
Melinda Grant (HP),
1351-
Håkon Wium Lie (Opera),
1352-
and
1353-
Jacob Refstrup (HP)
1354-
for their contributions to this specification,
1355-
which is a successor of their work there.
1356-
</p>
1357-
1358-
<h2 class="no-num" id="priv-sec">
1359-
Privacy and Security Considerations</h2>
1360-
1361-
This specification introduces no new privacy or security considerations over CSS in general.

css-break-4/Overview.bs

Lines changed: 48 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,13 @@ Ignored Terms: background positioning area, region chain, … message topic …,
1616
At Risk: the ''break-before/all'' value of 'break-before'/'break-after'
1717
</pre>
1818

19+
<pre class=link-defaults>
20+
spec:css-borders-4;
21+
type:property; text:border-image
22+
type:property; text:border-radius
23+
type:property; text:box-shadow
24+
</pre>
25+
1926
<h1>CSS Fragmentation Module Level 4 <br> <small>Breaking the Web, one fragment at a time</small></h1>
2027

2128
<h2 id="intro">
@@ -134,7 +141,7 @@ Fragmentation Model and Terminology</h2>
134141
and the edge of the <a>fragmentainer</a>.
135142
</dl>
136143

137-
Each <dfn export>fragmentation break</dfn> (hereafter, <dfn>break</dfn>)
144+
Each <dfn export>fragmentation break</dfn> (hereafter, <dfn export>break</dfn>)
138145
ends layout of the fragmented box in the current <a>fragmentainer</a>
139146
and causes the remaining content to be laid out in the next <a>fragmentainer</a>,
140147
in some cases causing a new <a>fragmentainer</a> to be generated
@@ -712,7 +719,7 @@ Unforced Breaks</h3>
712719
Finally, if there are no possible break points below the top of the fragmentainer,
713720
and not all the content fits, the UA may break anywhere
714721
in order to avoid losing content off the edge of the fragmentainer.
715-
<span id="monolithic-breaking">
722+
<span id="monolithic-breaking"></span>
716723
In such cases, the UA may also fragment the contents of <a>monolithic</a> elements
717724
by slicing the element's graphical representation.
718725
However, the UA must not break at the top of the page,
@@ -838,6 +845,7 @@ Breaking into Varying-size Fragmentainers</h3>
838845
in addition to its padding and border.
839846
<div class="figure">
840847
<img src="images/Varying-Size-Fragmentainers.svg"
848+
width="576"
841849
style="width: 75%"
842850
alt="Illustration: Breaking in varying-size fragmentainers" >
843851
<p class="caption">
@@ -995,36 +1003,40 @@ Adjoining Margins at Breaks: the 'margin-break' property</h3>
9951003

9961004
<figure>
9971005
<img src="images/margin-break-auto.png"
998-
alt="Here the top margin is kept on the first paragraph and the heading
999-
(which starts after a forced break)
1000-
but not after the second paragraph
1001-
(which starts after an unforced break).
1002-
The bottom margins are all discarded
1003-
at the bottom of each column.">
1006+
alt="Here the top margin is kept on the first paragraph and the heading
1007+
(which starts after a forced break)
1008+
but not after the second paragraph
1009+
(which starts after an unforced break).
1010+
The bottom margins are all discarded
1011+
at the bottom of each column."
1012+
width="595">
10041013
<figcaption>''margin-break: auto'' (initial value)</figcaption>
10051014
</figure>
10061015

10071016
<figure>
10081017
<img src="images/margin-break-discard.png"
1009-
alt="Here the top margins occurring at the top of each column
1010-
and the bottom margins occurring at the bottom of each column
1011-
are all truncated to zero.">
1018+
alt="Here the top margins occurring at the top of each column
1019+
and the bottom margins occurring at the bottom of each column
1020+
are all truncated to zero."
1021+
width="595">
10121022
<figcaption>''margin-break: discard''</figcaption>
10131023
</figure>
10141024

10151025
<figure>
10161026
<img src="images/margin-break-keep-discard.png"
1017-
alt="Here the top margins occurring at the top of each column
1018-
are all kept; however the bottom margins are still truncated.">
1027+
alt="Here the top margins occurring at the top of each column
1028+
are all kept; however the bottom margins are still truncated."
1029+
width="595">
10191030
<figcaption>''margin-break: keep discard''</figcaption>
10201031
</figure>
10211032

10221033
<figure>
10231034
<img src="images/margin-break-keep-keep.png"
1024-
alt="Here the top margins occurring at the top of each column
1025-
as well as the bottom margins occurring at the bottom of each column
1026-
are all kept; this increases the height of the auto-height container
1027-
to accommodate the bottom margins.">
1035+
alt="Here the top margins occurring at the top of each column
1036+
as well as the bottom margins occurring at the bottom of each column
1037+
are all kept; this increases the height of the auto-height container
1038+
to accommodate the bottom margins."
1039+
width="595">
10281040
<figcaption>''margin-break: keep keep''</figcaption>
10291041
</figure>
10301042
</div>
@@ -1063,8 +1075,9 @@ Splitting Boxes</h3>
10631075

10641076
<div class="figure">
10651077
<img
1066-
style="width: 80%"
10671078
src="images/Remaining-Fragmentainer-Extent.svg"
1079+
width="300"
1080+
style="width: 80%"
10681081
alt="Illustration: Filling remaining fragmentainer extent">
10691082
<p class="caption">
10701083
Illustration of filling the <a>remaining fragmentainer extent</a>.
@@ -1123,10 +1136,13 @@ Fragmented Borders and Backgrounds: the 'box-decoration-break' property</h3>
11231136
</dl>
11241137

11251138
<div class="figure">
1126-
<img alt="Illustration:
1127-
(1) a single box cut in two in between two lines of text by a page break and
1128-
(2) two boxes, one before and one after the page break,
1129-
both with a border all around and their own background image" src="images/box-break.png">
1139+
<img
1140+
src="images/box-break.png"
1141+
alt="Illustration:
1142+
(1) a single box cut in two in between two lines of text by a page break and
1143+
(2) two boxes, one before and one after the page break,
1144+
both with a border all around and their own background image"
1145+
width="450">
11301146

11311147
<p class=caption>Two possibilities for 'box-decoration-break':
11321148
on the left, the value ''slice'', on the right the value ''clone''.
@@ -1234,7 +1250,8 @@ Transforms, Positioning, and Pagination</h3>
12341250

12351251
<div class="figure">
12361252
<img alt="Illustration: Transformed overflow fragmentation"
1237-
src="images/fragmented-transforms.png">
1253+
src="images/fragmented-transforms.png"
1254+
width="144">
12381255
<p class=caption>A fixed-height box spanning 2.5 pages with overflow content spanning
12391256
to a total of 4 pages.
12401257
The transform origin of each fragment is the center of its border box;
@@ -1252,10 +1269,15 @@ Transforms, Positioning, and Pagination</h3>
12521269
are not required to correctly position absolutely-positioned elements
12531270
that end up on a previously-rendered page.
12541271

1255-
<h2 class="no-num" id="priv-sec">
1256-
Privacy and Security Considerations</h2>
1272+
<h2 class="no-num" id="privacy">
1273+
Privacy Considerations</h2>
1274+
1275+
This specification introduces no new privacy considerations over CSS in general.
1276+
1277+
<h2 class="no-num" id="security">
1278+
Security Considerations</h2>
12571279

1258-
This specification introduces no new privacy or security considerations over CSS in general.
1280+
This specification introduces no new security considerations over CSS in general.
12591281

12601282
<h2 class="no-num" id="changes">
12611283
Changes</h2>

0 commit comments

Comments
 (0)