Skip to content

Commit af397be

Browse files
committed
[mediaqueries] Replace "screen" with "Web-exposed screen area" where relevant
This protects privacy by limited the amount information UAs are required to expose. This commit also reduces usage of the ambiguous word "screen" where it was inaccurate or unneeded. Closes w3c#426
1 parent 6683af1 commit af397be

1 file changed

Lines changed: 20 additions & 12 deletions

File tree

mediaqueries/Overview.bs

Lines changed: 20 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -946,10 +946,10 @@ Error Handling</h3>
946946
-->
947947

948948
<h2 id="mf-dimensions">
949-
Screen/Device Dimensions Media Features</h2>
949+
Viewport/Page Dimensions Media Features</h2>
950950

951951
<h3 id="width">
952-
Screen Width: the 'width' feature</h3>
952+
Width: the 'width' feature</h3>
953953

954954
<pre class='descdef mq'>
955955
Name: width
@@ -993,7 +993,7 @@ Screen Width: the 'width' feature</h3>
993993

994994

995995
<h3 id="height">
996-
Screen Height: the 'height' feature</h3>
996+
Height: the 'height' feature</h3>
997997

998998
<pre class='descdef mq'>
999999
Name: height
@@ -1011,7 +1011,7 @@ Screen Height: the 'height' feature</h3>
10111011
Negative <<length>>s are invalid.
10121012

10131013
<h3 id='aspect-ratio'>
1014-
Screen Aspect-Ratio: the 'aspect-ratio' feature</h3>
1014+
Aspect-Ratio: the 'aspect-ratio' feature</h3>
10151015

10161016
<pre class='descdef mq'>
10171017
Name: aspect-ratio
@@ -1031,7 +1031,7 @@ Screen Aspect-Ratio: the 'aspect-ratio' feature</h3>
10311031

10321032

10331033
<h3 id='orientation'>
1034-
Screen Orientation: the 'orientation' feature</h3>
1034+
Orientation: the 'orientation' feature</h3>
10351035

10361036
<pre class='descdef mq'>
10371037
Name: orientation
@@ -1070,7 +1070,7 @@ Screen Orientation: the 'orientation' feature</h3>
10701070
Display Quality Media Features</h2>
10711071

10721072
<h3 id="resolution">
1073-
Screen Resolution: the 'resolution' feature</h3>
1073+
Display Resolution: the 'resolution' feature</h3>
10741074

10751075
<pre class='descdef mq'>
10761076
Name: resolution
@@ -1133,7 +1133,7 @@ Screen Resolution: the 'resolution' feature</h3>
11331133

11341134

11351135
<h3 id="scan">
1136-
Screen Display Type: the 'scan' feature</h3>
1136+
Display Type: the 'scan' feature</h3>
11371137

11381138
<pre class='descdef mq'>
11391139
Name: scan
@@ -1209,7 +1209,7 @@ Detecting Console Displays: the 'grid' feature</h3>
12091209

12101210

12111211
<h3 id="update">
1212-
Screen Update Frequency: the 'update' feature</h3>
1212+
Display Update Frequency: the 'update' feature</h3>
12131213

12141214
<pre class='descdef mq'>
12151215
Name: update
@@ -1341,7 +1341,7 @@ Color Media Features</h2>
13411341

13421342

13431343
<h3 id="color">
1344-
Screen Color Depth: the 'color' feature</h3>
1344+
Color Depth: the 'color' feature</h3>
13451345

13461346
<pre class='descdef mq'>
13471347
Name: color
@@ -2018,7 +2018,7 @@ device-width</h3>
20182018
</pre>
20192019

20202020
The 'device-width' media feature describes the width of the rendering surface of the output device.
2021-
For continuous media, this is the width of the screen.
2021+
For continuous media, this is the width of the <a>Web-exposed screen area</a>.
20222022
For paged media, this is the width of the page sheet size.
20232023

20242024
Negative <<length>>s are invalid.
@@ -2047,7 +2047,7 @@ device-height</h3>
20472047
</pre>
20482048

20492049
The 'device-height' media feature describes the height of the rendering surface of the output device.
2050-
For continuous media, this is the height of the screen.
2050+
For continuous media, this is the height of the <a>Web-exposed screen area</a>.
20512051
For paged media, this is the height of the page sheet size.
20522052

20532053
Negative <<length>>s are invalid.
@@ -2124,7 +2124,8 @@ The following changes were made to this specification since the
21242124
All media types except for ''screen'', ''print'', ''speech'', and ''all'' are deprecated.
21252125

21262126
<li>
2127-
Deprecated 'device-width', 'device-height', 'device-aspect-ratio'
2127+
Deprecated 'device-width', 'device-height', 'device-aspect-ratio',
2128+
and made them refer to the <a>Web-exposed screen area</a> instead of the screen for privacy and security reasons.
21282129
</ul>
21292130

21302131

@@ -2172,3 +2173,10 @@ making this a somewhat more robust detection technique.
21722173

21732174
That said, the information granted by Media Queries is relatively coarse,
21742175
and does not contribute much entropy in this regard.
2176+
2177+
A few legacy Media Features ('device-width', 'device-height', and 'device-aspect-ratio')
2178+
expose information about the environment in which the UA is running
2179+
without any clear benefit to doing so.
2180+
They are retained for compatibility reasons,
2181+
but for the sake of privacy and security,
2182+
UAs have been allowed to report inacurate information.

0 commit comments

Comments
 (0)