Skip to content

Commit e0dfb0f

Browse files
committed
[mediaqueries-5] Clarify prefers-color-scheme.
Fixes #3278.
1 parent e7b0b56 commit e0dfb0f

File tree

1 file changed

+13
-9
lines changed

1 file changed

+13
-9
lines changed

mediaqueries-5/Overview.bs

+13-9
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ Evaluating Media Features in a Boolean Context</h4>
4949
<em>other than</em> the number ''0'',
5050
a <<dimension>> with the value ''0'',
5151
the keyword ''@media/update/none'',
52-
or a value explicitely defined by that media feature to evaluate as false in a boolean context,
52+
or a value explicitly defined by that media feature to evaluate as false in a boolean context,
5353
the <a>media feature</a> evaluates to true.
5454
Otherwise, it evaluates to false.
5555

@@ -622,8 +622,8 @@ Detecting the desire for light or dark color schemes: the 'prefers-color-scheme'
622622
Type: discrete
623623
</pre>
624624

625-
The 'prefers-color-scheme' media feature is used to detect if the user
626-
has requested the page use a light or dark color theme.
625+
The 'prefers-color-scheme' media feature reflects the user's
626+
desire that the page use a light or dark color theme.
627627

628628
<dl dfn-type=value dfn-for="@media/prefers-color-scheme">
629629
<dt><dfn>no-preference</dfn>
@@ -634,18 +634,22 @@ Detecting the desire for light or dark color schemes: the 'prefers-color-scheme'
634634

635635
<dt><dfn>light</dfn>
636636
<dd>
637-
Indicates that user has notified the system that they
638-
prefer a page that has a light theme (dark text on light background).
637+
Indicates that user has expressed the preference for
638+
a page that has a light theme (dark text on light background).
639639

640640
<dt><dfn>dark</dfn>
641641
<dd>
642-
Indicates that user has notified the system that they
643-
prefer a page that has a dark theme (light text on dark background).
642+
Indicates that user has expressed the preference for
643+
a page that has a dark theme (light text on dark background).
644644

645645
</dl>
646646

647-
Note: User preferences can vary by medium;
648-
for example, a user may prefer dark themes on a glowing screen,
647+
The method by which the user expresses their preference can vary.
648+
It might be a system-wide setting exposed by the Operating System,
649+
or a setting controlled by the User Agent.
650+
651+
Note: User preferences can also vary by medium.
652+
For example, a user may prefer dark themes on a glowing screen,
649653
but light themes when printing
650654
(to save ink
651655
and/or because inked text on blank paper prints better

0 commit comments

Comments
 (0)