Skip to content

Commit 71e3d0a

Browse files
committed
Add the 'color-gamut' query function
1 parent 0d2e58e commit 71e3d0a

File tree

1 file changed

+43
-0
lines changed

1 file changed

+43
-0
lines changed

mediaqueries/Overview.bs

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1447,6 +1447,49 @@ inverted-colors</h3>
14471447
</pre>
14481448
</div>
14491449

1450+
<h3 id="color-gamut">
1451+
color-gamut</h3>
1452+
1453+
<pre class='descdef mq'>
1454+
Name: color-gamut
1455+
Value: srgb | p3 | rec2020
1456+
For: @media
1457+
Type: range
1458+
</pre>
1459+
1460+
The 'color-gamut' media feature describes the approximate range of colors that are
1461+
supported by the browser and display device. That is, if the browser receives content
1462+
with colors in the specified space it can cause the display to render the appropriate
1463+
color, or something appropriately close enough.
1464+
1465+
The query uses approximate ranges for a few reasons. Firstly, there are a lot of differences in
1466+
display hardware. For example, a device might claim to support "Rec 2020", but actually
1467+
renders a significantly lower range of the full gamut. Secondly, there are a lot of different
1468+
color ranges that different devices support, and enumerating them all would be tedious.
1469+
In most cases the author does not need to know the exact capabilities of the display, just
1470+
whether it is better than sRGB, or significantly better than sRGB. That way they can serve
1471+
appropriate images, tagged with color profiles, to the user.
1472+
1473+
The value 'srgb' represents a display that corresponds to the sRGB Color Space [[!SRGB]].
1474+
It is expected that the vast majority of color displays will be able to return true
1475+
to a query of this type.
1476+
1477+
The value 'p3' represents a display that can handle colors in approximately the gamut
1478+
specified by the DCI P3 Color Space.
1479+
1480+
The value 'rec2020' represents a display that can handle colors in approximately the gamut
1481+
specified by the ITU-R Recommendation BT.2020 Color Space.
1482+
1483+
<div class="example">
1484+
For example, this media query applies when the display supports colors
1485+
in the range of DCI P3:
1486+
1487+
<pre>
1488+
@media (color-gamut: p3) { … }
1489+
</pre>
1490+
</div>
1491+
1492+
14501493

14511494
<!--
14521495
████ ██ ██ ████████ ████████ ████████ ███ ██████ ████████ ████ ███████ ██ ██

0 commit comments

Comments
 (0)