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

+7-5
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

+6-4
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

+10-7
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

+2-2
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

+1-1
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

+3-3
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

+1-1
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

+4-2
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

+3-6
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

+1-1
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>

css-tables-3/Overview.bs

+1-1
Original file line numberDiff line numberDiff line change
@@ -2891,7 +2891,7 @@ With a table-internal box as non-containing block parent</h3>
28912891
<!--——————————————————————————————————————————————————————————————————————————-->
28922892
<h3 id="repeated-headers">Repeating headers across pages</h3>
28932893

2894-
When rendering the document into a paged media,
2894+
When rendering the document into a [=paged media=],
28952895
user agents must repeat
28962896
<a href="#table-header-group">header rows</a> and
28972897
<a href="#table-footer-group">footer rows</a>

css-values-3/Overview.bs

+2-2
Original file line numberDiff line numberDiff line change
@@ -1160,7 +1160,7 @@ Viewport-percentage Lengths: the ''vw'', ''vh'', ''vmin'', ''vmax'' units</h4>
11601160
they are scaled accordingly.
11611161
However, any scrollbars are assumed not to exist.
11621162

1163-
For paged media, the exact definition of the viewport-percentage lengths
1163+
For [=paged media=], the exact definition of the viewport-percentage lengths
11641164
is deferred to [[!CSS3PAGE]].
11651165

11661166
<dl export dfn-type=value dfn-for="<length>">
@@ -2550,7 +2550,7 @@ Changes</h2>
25502550
made <a href="#viewport-relative-lengths">viewport-percentage units</a> respect scrollbars on the viewport
25512551
unless 'overflow' is ''overflow/auto'' (in which case they ignore the presence of scrollbars).
25522552
<li>Deferred exact definition of <a href="#viewport-relative-lengths">viewport-percentage units</a>
2553-
in paged media to <a href="https://www.w3.org/TR/css3-page/">CSS Paged Media</a>.
2553+
in [=paged media=] to <a href="https://www.w3.org/TR/css3-page/">CSS Paged Media</a>.
25542554
<li>Added back the <<custom-ident>> term as a convenience notation, so that other specs can refer to it.
25552555
</ul>
25562556

css-values-4/Overview.bs

+1-1
Original file line numberDiff line numberDiff line change
@@ -1525,7 +1525,7 @@ Viewport-percentage Lengths: the ''vw'', ''vh'', ''vi'', ''vb'', ''vmin'', ''vma
15251525
any scroll bars are assumed not to exist.
15261526
<span class='note'>Note that the initial containing block's size is affected by the presence of scrollbars on the viewport.</span>
15271527

1528-
For paged media, the exact definition of the viewport-percentage lengths
1528+
For [=paged media=], the exact definition of the viewport-percentage lengths
15291529
is deferred to [[!CSS3PAGE]].
15301530

15311531
<dl export dfn-type=value dfn-for="<length>">

css-writing-modes-3/Overview.bs

+1-1
Original file line numberDiff line numberDiff line change
@@ -2293,7 +2293,7 @@ Propagation to the Initial Containing Block</h3>
22932293
<h3 id="page-direction">
22942294
Page Flow: the page progression direction</h2>
22952295

2296-
<p>In paged media CSS classifies all pages as either left or right pages.
2296+
<p>In [=paged media=] CSS classifies all pages as either left or right pages.
22972297
The <a>page progression</a> direction (see [[CSS3PAGE]]),
22982298
which determines whether the left or right page in a spread is first in the flow
22992299
and whether the first page is by default a left or right page,

css-writing-modes-4/Overview.bs

+1-1
Original file line numberDiff line numberDiff line change
@@ -2499,7 +2499,7 @@ Propagation to the Initial Containing Block</h3>
24992499
<h3 id="page-direction">
25002500
Page Flow: the page progression direction</h2>
25012501

2502-
<p>In paged media CSS classifies all pages as either left or right pages.
2502+
<p>In [=paged media=] CSS classifies all pages as either left or right pages.
25032503
The <a>page progression</a> direction (see [[CSS3PAGE]]),
25042504
which determines whether the left or right page in a spread is first in the flow
25052505
and whether the first page is by default a left or right page,

mediaqueries-4/Overview.bs

+15-9
Original file line numberDiff line numberDiff line change
@@ -1081,10 +1081,10 @@ Width: the '@media/width' feature</h3>
10811081
</pre>
10821082

10831083
The '@media/width' media feature describes the width of the targeted display area of the output device.
1084-
For continuous media, this is the width of the viewport
1084+
For [=continuous media=], this is the width of the viewport
10851085
(as described by CSS2, section 9.1.1 [[!CSS21]])
10861086
including the size of a rendered scroll bar (if any).
1087-
For paged media, this is the width of the page box
1087+
For [=paged media=], this is the width of the page box
10881088
(as described by CSS2, section 13.2 [[!CSS21]]).
10891089

10901090
<<length>>s are interpreted according to [[#units]].
@@ -1125,8 +1125,8 @@ Height: the '@media/height' feature</h3>
11251125
</pre>
11261126

11271127
The '@media/height' media feature describes the height of the targeted display area of the output device.
1128-
For continuous media, this is the height of the viewport including the size of a rendered scroll bar (if any).
1129-
For paged media, this is the height of the page box.
1128+
For [=continuous media=], this is the height of the viewport including the size of a rendered scroll bar (if any).
1129+
For [=paged media=], this is the height of the page box.
11301130

11311131
<<length>>s are interpreted according to [[#units]].
11321132

@@ -1418,6 +1418,9 @@ Block-Axis Overflow: the '@media/overflow-block' feature</h3>
14181418
Examples: printers, ebook readers
14191419
</dl>
14201420

1421+
Media that match ''overflow-block/none'' or ''overflow-block/scroll'' are said to be <dfn export>continuous media</dfn>,
1422+
while those that match ''overflow-block/paged'' or ''overflow-block/optional-paged'' are said to be <dfn export>paged media</dfn>
1423+
14211424
<h3 id='mf-overflow-inline'>
14221425
Inline-Axis Overflow: the '@media/overflow-inline' feature</h3>
14231426

@@ -2082,8 +2085,8 @@ device-width</h3>
20822085
</pre>
20832086

20842087
The 'device-width' media feature describes the width of the rendering surface of the output device.
2085-
For continuous media, this is the width of the <a>Web-exposed screen area</a>.
2086-
For paged media, this is the width of the page sheet size.
2088+
For [=continuous media=], this is the width of the <a>Web-exposed screen area</a>.
2089+
For [=paged media=], this is the width of the page sheet size.
20872090

20882091
'@media/device-width' is <a>false in the negative range</a>.
20892092

@@ -2111,8 +2114,8 @@ device-height</h3>
21112114
</pre>
21122115

21132116
The 'device-height' media feature describes the height of the rendering surface of the output device.
2114-
For continuous media, this is the height of the <a>Web-exposed screen area</a>.
2115-
For paged media, this is the height of the page sheet size.
2117+
For [=continuous media=], this is the height of the <a>Web-exposed screen area</a>.
2118+
For [=paged media=], this is the height of the page sheet size.
21162119

21172120
'@media/device-height' is <a>false in the negative range</a>.
21182121

@@ -2187,6 +2190,9 @@ The following changes were made to this specification since the
21872190

21882191
<li>
21892192
Various editorial tweaks, phrasing improvements, and clarifications.
2193+
2194+
<li>
2195+
Add definitions for the terms [=continuous media=] and [=paged media=].
21902196
</ul>
21912197

21922198
<h3 id="changes-2017">
@@ -2195,7 +2201,7 @@ The following changes were made to this specification since the
21952201
<a href="https://www.w3.org/TR/2017/WD-mediaqueries-4-20170519/">19 May 2017 Working Draft </a>:
21962202
<ul>
21972203
<li>Changed range media features to be <a>false in the negative range</a> instead of failing to parse negative values.
2198-
<li>Included enough informaton about the color spaces needed by 'color-gamut' directly into the specification.
2204+
<li>Included enough information about the color spaces needed by 'color-gamut' directly into the specification.
21992205
</ul>
22002206

22012207
<h3 id="changes-2012">

mediaqueries-4/issues-cr-2017-09-05.txt

+2-1
Original file line numberDiff line numberDiff line change
@@ -135,7 +135,8 @@ Issue 19.
135135
Summary: Define Media Groups: continuous vs paged, etc.
136136
From: Elika Etemad
137137
Comment: https://github.com/w3c/csswg-drafts/issues/5019
138-
Open
138+
Closed: Accepted
139+
Resolved: https://github.com/w3c/csswg-drafts/issues/5019#issuecomment-638521048
139140
----
140141
Issue 20.
141142
Summary: Miscelaneous comments from accessibility Review

0 commit comments

Comments
 (0)