Skip to content

Commit 090e43f

Browse files
committed
Define "paged" and "continuous" media
Closes #5019
1 parent eefbe24 commit 090e43f

File tree

18 files changed

+67
-53
lines changed

18 files changed

+67
-53
lines changed

css-break-3/Overview.bs

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,19 +22,20 @@ At Risk: the ''region'' and ''break-after/avoid-region'' values of 'break-*'
2222
<h2 id="intro">
2323
Introduction</h2>
2424

25+
<div class=non-normative>
2526
<p><em>This section is not normative.</em></p>
2627
<p>
27-
In paged media (e.g., paper, transparencies, photo album pages, pages
28+
In [=paged media=] (e.g., paper, transparencies, photo album pages, pages
2829
displayed on computer screens as printed output simulations), as
29-
opposed to <a href="https://www.w3.org/TR/CSS2/media.html#continuous-media-group">
30-
continuous media</a>, the content of the document is split into one or
30+
opposed to [=continuous media=],
31+
the content of the document is split into one or
3132
more discrete display surfaces. In order to avoid awkward breaks
3233
(such as halfway through a line of text), the layout engine must be
3334
able to shift around content that would fall across the page break.
3435
This process is called <dfn export>pagination</dfn>.
3536
</p>
3637
<p>
37-
In CSS, in addition to paged media, certain layout features such as
38+
In CSS, in addition to [=paged media=], certain layout features such as
3839
<a href="https://www.w3.org/TR/css3-regions/">regions</a> [[CSS3-REGIONS]]
3940
and <a href="https://www.w3.org/TR/css3-multicol/">multi-column layout</a>
4041
[[CSS3COL]] create a similarly fragmented environment.
@@ -44,6 +45,7 @@ Introduction</h2>
4445
such as pages and columns and how such breaks can be
4546
<a href="#breaking-controls">controlled by the author</a>.
4647
</p>
48+
</div>
4749

4850
<h3 id="placement">
4951
Module Interactions</h3>
@@ -86,7 +88,7 @@ Fragmentation Model and Terminology</h2>
8688
An ordered series of <a>fragmentainers</a>,
8789
such as created by a <a href="https://www.w3.org/TR/css3-multicol/">multi-column container</a>,
8890
a chain of <a href="https://www.w3.org/TR/css3-regions">CSS regions</a>,
89-
or a <a href="https://www.w3.org/TR/css3-page/">paged media display</a>.
91+
or a [=paged media=] display.
9092
A given fragmentation context can only have one block flow direction
9193
across all its <a>fragmentainers</a>.
9294
(Descendants of the <a>fragmentation root</a> may have other block flow directions,

css-break-4/Overview.bs

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,12 +21,13 @@ At Risk: the ''break-before/all'' value of 'break-before'/'break-after'
2121
<h2 id="intro">
2222
Introduction</h2>
2323

24+
<div class=non-normative>
2425
<em>This section is not normative.</em>
2526

26-
In paged media
27+
In [=paged media=]
2728
(e.g., paper, transparencies, photo album pages,
2829
pages displayed on computer screens as printed output simulations),
29-
as opposed to <a href="https://www.w3.org/TR/CSS2/media.html#continuous-media-group">continuous media</a>,
30+
as opposed to [=continuous media=],
3031
the content of the document is split into
3132
one or more discrete display surfaces.
3233
In order to avoid awkward breaks
@@ -35,7 +36,7 @@ Introduction</h2>
3536
that would fall across the page break.
3637
This process is called <dfn export>pagination</dfn>.
3738

38-
In CSS, in addition to paged media,
39+
In CSS, in addition to [=paged media=],
3940
certain layout features such as
4041
<a href="https://www.w3.org/TR/css3-regions/">regions</a> [[CSS3-REGIONS]]
4142
and <a href="https://www.w3.org/TR/css-multicol-1/">multi-column layout</a> [[CSS-MULTICOL-1]]
@@ -52,6 +53,7 @@ Introduction</h2>
5253
except for the addition of the 'margin-break' property
5354
and the ''break-before/always'' and ''break-before/all'' values
5455
of the 'break-before' and 'break-after' properties.
56+
</div>
5557

5658
<h3 id="placement">
5759
Module Interactions</h3>
@@ -94,7 +96,7 @@ Fragmentation Model and Terminology</h2>
9496
An ordered series of <a>fragmentainers</a>,
9597
such as created by a <a href="https://www.w3.org/TR/css-multicol-1/">multi-column container</a>,
9698
a chain of <a href="https://www.w3.org/TR/css3-regions">CSS regions</a>,
97-
or a <a href="https://www.w3.org/TR/css-page-3/">paged media display</a>.
99+
or a [=paged media=] display.
98100
A given fragmentation context can only have one block flow direction
99101
across all its <a>fragmentainers</a>.
100102
(Descendants of the <a>fragmentation root</a> may have other block flow directions,

css-device-adapt-1/Overview.bs

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,12 @@ Ignored Vars: <viewport-length>
2222
<h2 id="intro">
2323
Introduction</h2>
2424

25+
<div class=non-normative>
2526
<em>This section is not normative.</em>
2627

2728
CSS 2.1 [[!CSS21]] specifies an
2829
<a href="https://www.w3.org/TR/CSS21/visudet.html#containing-block-details">
29-
initial containing block</a> for continuous media that has the dimensions
30+
initial containing block</a> for [=continuous media=] that has the dimensions
3031
of the <a href="https://www.w3.org/TR/CSS21/visuren.html#viewport">
3132
viewport</a>. Since the viewport is generally no larger than the display,
3233
devices with smaller displays such as phones or tablets typically present
@@ -61,6 +62,7 @@ for a good discussion of these issues.
6162

6263
Issue: Various issues about this specification and related specifications
6364
are listed in <a href="https://www.w3.org/Graphics/SVG/WG/wiki/Proposals/Investigation_of_APIs_for_Level_of_detail#The_issues_on_existing_APIs">this report</a>.
65+
</div>
6466

6567
<h2 id="scenarios">
6668
Motivating Scenarios</h2>
@@ -135,12 +137,13 @@ Value types are defined in [[!CSS3VAL]].
135137
The viewport</h2>
136138

137139
In CSS 2.1 a <a href="https://www.w3.org/TR/CSS21/visuren.html#viewport">viewport</a>
138-
is a feature of a user agent for continuous media and used to
139-
establish the initial containing block for continuous media. For paged
140-
media, the initial containing block is based on the page area. The
141-
page area can be set through ''@page'' rules. Hence, ''@viewport''
142-
applies to continuous media, and ''@page'' to paged media, and they
143-
will not interact or conflict.
140+
is a feature of a user agent for [=continuous media=] and used to
141+
establish the initial containing block for [=continuous media=].
142+
For [=paged media=], the initial containing block is based on the page area.
143+
The page area can be set through ''@page'' rules.
144+
Hence, ''@viewport'' applies to [=continuous media=],
145+
and ''@page'' to [=paged media=],
146+
and they will not interact or conflict.
144147

145148
This specification introduces a way of overriding the size of the viewport
146149
provided by the user agent (UA). Because of this, we need to introduce the

css-display-3/Overview.bs

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1078,8 +1078,8 @@ Appendix A: Glossary</h2>
10781078
<dt><dfn>initial containing block</dfn>
10791079
<dd>
10801080
The <a>containing block</a> of the root element.
1081-
See <a href="https://www.w3.org/TR/CSS2/visudet.html#containing-block-details">CSS2.1&sect;10.1</a> for continuous media;
1082-
and [[!CSS3PAGE]] for paged media.
1081+
See <a href="https://www.w3.org/TR/CSS2/visudet.html#containing-block-details">CSS2.1&sect;10.1</a> for [=continuous media=];
1082+
and [[!CSS3PAGE]] for [=paged media=].
10831083

10841084
<dt><dfn>formatting context</dfn>
10851085
<dd>

css-line-grid-1/Overview.bs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -243,7 +243,7 @@ Defining a <dfn>Line Grid</dfn>: the 'line-grid' property</h2>
243243
has a value of ''match-parent'',
244244
then it adopts the <a>line grid</a> of the initial containing block.
245245

246-
In paged media,
246+
In [=paged media=],
247247
if the page context applying to a particular page
248248
specifies ''line-grid: create'',
249249
then a <a>line grid</a> for that page is established

css-multicol-1/Overview.bs

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -650,7 +650,7 @@ Two assumptions are being made by the pseudo-algorithm:
650650
the UA must floor the column size to a UA-specified value to avoid division by zero.
651651
It is suggested that this floor be 1px or less.
652652

653-
In fragmented contexts such as in paged media,
653+
In fragmented contexts such as in [=paged media=],
654654
user agents may perform this calculation on a per-fragment basis.
655655

656656
The used value for 'column-count' is calculated without regard for explicit column breaks or constrained column heights,
@@ -1207,7 +1207,7 @@ h2 {
12071207

12081208
<div class="example">
12091209
In fragmented contexts spanning elements are honored in all fragments.
1210-
In this example, we are in paged media,
1210+
In this example, we are in [=paged media=],
12111211
and the first three paragraphs have column breaks after them.
12121212
A spanning <code>H2</code> element appears after the fourth paragraph.
12131213

@@ -1542,7 +1542,7 @@ Pagination and Overflow Outside Multicol Containers</h3>
15421542
</div>
15431543

15441544
<div class="example">
1545-
In paged media, extra columns are shown on the next page.
1545+
In [=paged media=], extra columns are shown on the next page.
15461546
Given the same code as the previous example,
15471547
the last paragraph appears on the second page.
15481548
This would appear on the first page:

css-overflow-3/Overview.bs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -462,7 +462,7 @@ Overflow in Print and Other Static Media</h3>
462462
such as by displaying scrollbars
463463
or an ellipsis.
464464

465-
Note: Not all paged media is non-interactive
465+
Note: Not all [=paged media=] is non-interactive
466466
for example, e-book readers page content,
467467
but are interactive.
468468

css-page-3/Overview.bs

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -73,9 +73,10 @@ spec:css2; type: property
7373
<h2 id="intro">
7474
Introduction</h2>
7575

76+
<div class=non-normative>
7677
Paged media (e.g., paper, transparencies, photo album pages, pages
7778
displayed on computer screens as printed output simulations) differ from
78-
<a href="https://www.w3.org/TR/CSS2/media.html#continuous-media-group">continuous media</a>
79+
[=continuous media=]
7980
in that the content of the document is split into one or more discrete
8081
static display surfaces. To handle pages, CSS3 Paged Media describes how:
8182

@@ -101,6 +102,7 @@ Introduction</h2>
101102
All properties defined in this specification also accept the
102103
<a href="https://www.w3.org/TR/CSS2/cascade.html#value-def-inherit">inherit</a>
103104
keyword as their value, but for readability it has not been listed explicitly.
105+
</div>
104106

105107
<h3 id="values">
106108
Value Definitions</h3>
@@ -214,7 +216,7 @@ Page Terminology</h2>
214216

215217
<h2 id="page-model">The Page Model</h2>
216218

217-
In the paged media formatting model, the document is transferred into one
219+
In the [=paged media=] formatting model, the document is transferred into one
218220
or more page boxes. The <dfn export>page box</dfn> is a specialized CSS
219221
box that maps to a rectangular print media surface, such as a page of paper.
220222
It is roughly analogous to the <a href="https://www.w3.org/TR/CSS2/visuren.html#viewport">viewport</a>.

css-position-3/Overview.bs

Lines changed: 3 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -102,9 +102,6 @@ Link Defaults: css-transforms-1 (property) transform
102102
urlPrefix: https://www.w3.org/TR/CSS2/visuren.html; spec: CSS2;
103103
url: #normal-flow; text: normal flow; type: dfn;
104104
url: #x1; text: viewport; type: dfn;
105-
urlPrefix: https://www.w3.org/TR/CSS21/media.html; spec: CSS2;
106-
url: #continuous-media-group; text: continuous media; type: dfn;
107-
url: #paged-media-group; text: paged media; type: dfn;
108105
urlPrefix: https://www.w3.org/TR/CSS2/visudet.html; spec: CSS2;
109106
url: #static-position; text: static position; type: dfn;
110107
url: #static-position; text: static-position containing block; type: dfn;
@@ -264,7 +261,7 @@ Choosing A Positioning Scheme: 'position' property</h2>
264261
<dd>
265262
Same as ''absolute'',
266263
except the box is positioned and sized relative to a [=fixed positioning containing block=]
267-
(the [=viewport=] in continuous media, or the [=page area=] in paged media).
264+
(the [=viewport=] in [=continuous media=], or the [=page area=] in [=paged media=]).
268265
The box’s position is fixed with respect to this reference rectangle:
269266
it does not move when the document is scrolled,
270267
and is replicated on every page when it is paginated.
@@ -347,15 +344,15 @@ Containing Blocks of Positioned Boxes</h3>
347344
If no ancestor establishes one,
348345
the [=fixed positioning containing block=] is:
349346

350-
* in <a href="https://www.w3.org/TR/CSS2/media.html#continuous-media-group">continuous media</a>,
347+
* in [=continuous media=],
351348
the <a>viewport</a>;
352349
as a result, [=fixed=] boxes do not move when the document is scrolled.
353350

354351
Note: In this respect, they are similar to
355352
[[css-backgrounds-3#the-background-attachment|fixed background images]]
356353
(''background-attachment: fixed'').
357354

358-
* in <a href="https://www.w3.org/TR/CSS2/media.html#paged-media-group">paged media</a>,
355+
* in [=paged media=],
359356
the [=page area=] of each page;
360357
[=fixed positioned=] [=boxes=] are thus replicated on every page.
361358
(They are fixed with respect to the page box only,

css-regions-1/Overview.bs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2055,7 +2055,7 @@ Relation to other specifications</h2>
20552055
CSS Fragmentation Module Level 3 [[CSS3-BREAK]].
20562056
This module defines the rules for fragmenting content over multiple containers
20572057
and applies to <a>CSS Regions</a>
2058-
in addition to applying to multi-column and paged media.
2058+
in addition to applying to multi-column and [=paged media=].
20592059
</li>
20602060

20612061
<li>

0 commit comments

Comments
 (0)