Skip to content

Commit 3283793

Browse files
committed
[mediaqueries-5] rename prefers-contrast high and low to more and less
Closes w3c#2943
1 parent bb3ecdb commit 3283793

File tree

1 file changed

+14
-18
lines changed

1 file changed

+14
-18
lines changed

mediaqueries-5/Overview.bs

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2629,7 +2629,7 @@ Detecting the desire for increased or decreased color contrast from elements on
26292629

26302630
<pre class='descdef mq'>
26312631
Name: prefers-contrast
2632-
Value: no-preference | high | low | forced
2632+
Value: no-preference | less | more | forced
26332633
For: @media
26342634
Type: discrete
26352635
</pre>
@@ -2647,15 +2647,15 @@ Detecting the desire for increased or decreased color contrast from elements on
26472647
to the system. This keyword value evaluates as false
26482648
in the <a>boolean context</a>.
26492649

2650-
<dt><dfn>high</dfn>
2650+
<dt><dfn>less</dfn>
26512651
<dd>
26522652
Indicates that user has notified the system that they
2653-
prefer an interface that has a higher level of contrast.
2653+
prefer an interface that has a lower level of contrast.
26542654

2655-
<dt><dfn>low</dfn>
2655+
<dt><dfn>more</dfn>
26562656
<dd>
26572657
Indicates that user has notified the system that they
2658-
prefer an interface that has a lower level of contrast.
2658+
prefer an interface that has a higher level of contrast.
26592659

26602660
<dt><dfn>forced</dfn>
26612661
<dd>
@@ -2666,22 +2666,22 @@ Detecting the desire for increased or decreased color contrast from elements on
26662666

26672667
<div class=advisement>
26682668
This does <em>not</em> necessarily indicates
2669-
a preference for a high contrast.
2669+
a preference for more contrast.
26702670
The colors have been forcibly adjusted
26712671
to match the preference of the user,
2672-
but that preference can be for a low contrast or a high one,
2672+
but that preference can be for less or more contrast,
26732673
or some other arrangement that is neither particularly low or high contrast.
26742674
</div>
26752675

26762676
Note: When the User Agent can determine whether the particular forced color scheme
26772677
chosen by the user is high or low contrast,
2678-
one of ''prefers-contrast: high'' or ''prefers-contrast: low'' should match,
2678+
one of ''prefers-contrast: more'' or ''prefers-contrast: less'' should match,
26792679
in addition to ''prefers-contrast: forced''.
26802680
</dl>
26812681

26822682
<div class=note>
2683-
Note: Authors can respond to specific user preferences for a higher or lower
2684-
contrast using ''prefers-contrast: high'' or ''prefers-contrast: low'',
2683+
Note: Authors can respond to specific user preferences for more or less
2684+
contrast using ''prefers-contrast: more'' or ''prefers-contrast: less'',
26852685
as appropriate.
26862686

26872687
Using an unqualified <code class=lang-css>@media (prefers-contrast) { … }</code>
@@ -2691,21 +2691,17 @@ Detecting the desire for increased or decreased color contrast from elements on
26912691
However, it is also common to reduce visual clutter
26922692
in response to both high and low contrast preferences.
26932693
In that case, it is appropriate to use <code class=lang-css>@media (prefers-contrast) { … }</code>
2694-
without specifying ''prefers-contrast/high'' or ''prefers-contrast/low'',
2694+
without specifying ''prefers-contrast/more'' or ''prefers-contrast/less'',
26952695
to do things like replacing background images with plain colors,
26962696
turning off decorative gradients,
26972697
or replacing border images or box shadows with simple solid borders.
2698-
As ''prefers-contrast/forced'', like ''prefers-contrast/high'' or ''prefers-contrast/low'',
2698+
As ''prefers-contrast/forced'', like ''prefers-contrast/more'' or ''prefers-contrast/less'',
26992699
evaluates to true in a [=boolean context=],
27002700
this syntax also benefits users of <a>forced colors mode</a>,
27012701
even when it isn't know whether their colors of choice
27022702
result in a high or low contrast (or something else).
27032703
</div>
27042704

2705-
ISSUE(2943): Split ''prefers-contrast/high'' into two levels,
2706-
“extremely high” (as used in MSFT's black-on-white high contrast theme)
2707-
and “increased (as implemented in Apple's Increased Contrast settings)?
2708-
27092705
<h3 id="prefers-color-scheme">
27102706
Detecting the desire for light or dark color schemes: the 'prefers-color-scheme' feature</h3>
27112707

@@ -2883,7 +2879,7 @@ Automatic handling of User Preferences</h3>
28832879
For instance, liquid crystal displays can be washed out and very hard to read
28842880
in brightly lit environments.
28852881
A device with such a screen and with an ambient light sensor
2886-
could automatically switch 'prefers-contrast' to ''prefers-contrast/high''
2882+
could automatically switch 'prefers-contrast' to ''prefers-contrast/more''
28872883
when it detects conditions that would make the screen difficult to read.
28882884
A user agent on a device with an e-ink display
28892885
would not make the same adjustment,
@@ -2892,7 +2888,7 @@ Automatic handling of User Preferences</h3>
28922888
In the opposite situation,
28932889
user agents running of device with a light-emitting screen (LCD, OLED, etc.)
28942890
and an ambient light sensor
2895-
could automatically switch 'prefers-contrast' to ''prefers-contrast/low''
2891+
could automatically switch 'prefers-contrast' to ''prefers-contrast/less''
28962892
and 'prefers-color-scheme' to ''prefers-color-scheme/dark''
28972893
when used in a dim environment
28982894
where excessive contrast and brightness would be distracting or uncomfortable to the reader.

0 commit comments

Comments
 (0)