Skip to content

Commit 727b969

Browse files
committed
[css-color-5] Define and use "conversion, if required" fix #8452
1 parent 46964ef commit 727b969

File tree

1 file changed

+21
-11
lines changed

1 file changed

+21
-11
lines changed

css-color-5/Overview.bs

Lines changed: 21 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -868,9 +868,9 @@ in the range [0, 360].
868868

869869
</div>
870870

871-
If the [=origin color=] was originally specified with a different color function,
871+
<p id="required-conversion">If the [=origin color=] was <dfn>originally specified</dfn> with a different color function,
872872
it's first converted into the chosen color function,
873-
so it has meaningful values for the channels.
873+
so it has meaningful values for the channels.</p>
874874

875875
<div class=example>
876876
By using the [=channel keywords=] in a [=math function=],
@@ -1018,7 +1018,7 @@ the allowed [=channel keywords=] are:
10181018
* <dfn value for="rgb()">r</dfn>, <dfn value for="rgb()">g</dfn>, and <dfn value for="rgb()">b</dfn>
10191019
are all <<number>>s
10201020
that correspond to the [=origin color's=] red, green, and blue channels
1021-
after its conversion to sRGB.
1021+
after <a href="#required-conversion">conversion, if required</a> to sRGB.
10221022
255.0 is equivalent to 100%.
10231023
* <dfn value for="rgb()">alpha</dfn> is a <<number>> that corresponds to the [=origin color's=] alpha transparency
10241024

@@ -1076,12 +1076,12 @@ the allowed [=channel keywords=] are:
10761076

10771077
* <dfn value for="hsl()">h</dfn> is an <<angle>>
10781078
that corresponds to the [=origin color's=] HSL hue
1079-
after its conversion to sRGB,
1079+
after <a href="#required-conversion">conversion, if required</a> to sRGB,
10801080
normalized to a [0, 360] range
10811081
* <dfn value for="hsl()">s</dfn> and <dfn value for="hsl()">l</dfn>
10821082
are <<percentage>>s that correspond to the [=origin color's=]
10831083
HSL saturation and lightness,
1084-
after its conversion to sRGB
1084+
after <a href="#required-conversion">conversion, if required</a> to sRGB
10851085
* <dfn value for="hsl()">alpha</dfn> is a <<number>> that corresponds to the [=origin color's=] alpha transparency
10861086

10871087
<div class="example">
@@ -1113,11 +1113,11 @@ the allowed [=channel keywords=] are:
11131113

11141114
* <dfn value for="hwb()">h</dfn> is an <<angle>>
11151115
that corresponds to the [=origin color's=] HWB hue
1116-
after its conversion to sRGB,
1116+
after <a href="#required-conversion">conversion, if required</a> to sRGB,
11171117
normalized to a [0, 360] range
11181118
* <dfn value for="hwb()">w</dfn> and <dfn value for="hwb()">b</dfn>
11191119
are <<percentage>>s that correspond to the [=origin color's=] HWB whiteness and blackness
1120-
after its conversion to sRGB
1120+
after <a href="#required-conversion">conversion, if required</a> to sRGB
11211121
* <dfn value for="hwb()">alpha</dfn> is a <<number>> that corresponds to the [=origin color's=] alpha transparency
11221122

11231123
<h3 id="relative-Lab">Relative Lab Colors</h3>
@@ -1138,8 +1138,10 @@ the allowed [=channel keywords=] are:
11381138

11391139
* <dfn value for="lab()">l</dfn> is a <<number>>
11401140
that corresponds to the [=origin color's=] CIE Lightness
1141+
after <a href="#required-conversion">conversion, if required</a>, to CIE Lab
11411142
* <dfn value for="lab()">a</dfn> and <dfn value for="lab()">b</dfn> are <<number>>s
11421143
that correspond to the [=origin color's=] CIELab a and b axes
1144+
after <a href="#required-conversion">conversion, if required</a>, to CIE Lab
11431145
* <dfn value for="lab()">alpha</dfn> is a <<number>> that corresponds to the [=origin color's=] alpha transparency
11441146

11451147
<div class="example">
@@ -1185,8 +1187,10 @@ the allowed [=channel keywords=] are:
11851187

11861188
* <dfn value for="oklab()">l</dfn> is a <<number>>
11871189
that corresponds to the [=origin color's=] Oklab Lightness
1190+
after <a href="#required-conversion">conversion, if required</a>, to Oklab
11881191
* <dfn value for="oklab()">a</dfn> and <dfn value for="oklab()">b</dfn> are <<number>>s
11891192
that correspond to the [=origin color's=] Oklab a and b axes
1193+
after <a href="#required-conversion">conversion, if required</a>, to Oklab
11901194
* <dfn value for="oklab()">alpha</dfn> is a <<number>> that corresponds to the [=origin color's=] alpha transparency
11911195

11921196
<h3 id="relative-LCH">Relative LCH Colors</h3>
@@ -1207,10 +1211,13 @@ the allowed [=channel keywords=] are:
12071211

12081212
* <dfn value for="lch()">l</dfn> is a <<number>>
12091213
that corresponds to the [=origin color's=] CIE Lightness
1214+
after <a href="#required-conversion">conversion, if required</a>, to CIE LCH
12101215
* <dfn value for="lch()">c</dfn> is a <<number>>
12111216
that corresponds to the [=origin color's=] LCH chroma
1217+
after <a href="#required-conversion">conversion, if required</a>, to CIE LCH
12121218
* <dfn value for="lch()">h</dfn> is an <<angle>>
12131219
that corresponds to the [=origin color's=] LCH hue,
1220+
after <a href="#required-conversion">conversion, if required</a>, to CIE LCH,
12141221
normalized to a [0, 360] range.
12151222
* <dfn value for="lch()">alpha</dfn> is a <<number>> that corresponds to the [=origin color's=] alpha transparency
12161223

@@ -1337,10 +1344,13 @@ the allowed [=channel keywords=] are:
13371344

13381345
* <dfn value for="oklch()">l</dfn> is a <<number>>
13391346
that corresponds to the [=origin color's=] Oklab Lightness
1347+
after <a href="#required-conversion">conversion, if required</a>, to Oklch
13401348
* <dfn value for="oklch()">c</dfn> is a <<number>>
13411349
that corresponds to the [=origin color's=] Oklch chroma
1350+
after <a href="#required-conversion">conversion, if required</a>, to Oklch
13421351
* <dfn value for="oklch()">h</dfn> is an <<angle>>
13431352
that corresponds to the [=origin color's=] Oklch hue,
1353+
after <a href="#required-conversion">conversion, if required</a>, to Oklch,
13441354
normalized to a [0, 360] range.
13451355
* <dfn value for="oklch()">alpha</dfn> is a <<number>> that corresponds to the [=origin color's=] alpha transparency
13461356

@@ -1437,22 +1447,22 @@ the number and name of the allowed [=channel keywords=] are:
14371447
* defined by the '@color-profile/components' descriptor on the corresponding ''@color-profile'',
14381448
if present;
14391449
otherwise, no relative color manipulation is valid. They are <<number>>s that correspond to the [=origin color's=] channels
1440-
after its conversion to the color space of the color profile. The value 1.0 corresponds to 100%.
1450+
after <a href="#required-conversion">conversion, if required</a> to the color space of the color profile. The value 1.0 corresponds to 100%.
14411451

14421452
Within a [=relative color=] syntax ''color()'' function using <<predefined-rgb-params>>,
14431453
the allowed [=channel keywords=] are:
14441454

14451455
* <dfn value for="color()">r</dfn>, <dfn value for="color()">g</dfn>, and <dfn value for="color()">b</dfn>
14461456
are all <<number>>s
14471457
that correspond to the [=origin color's=] red, green, and blue channels
1448-
after its conversion to the predefined RGB color space.
1458+
after <a href="#required-conversion">conversion, if required</a> to the predefined RGB color space.
14491459

14501460
Within a [=relative color=] syntax ''color()'' function using <<xyz-params>>,
14511461
the allowed [=channel keywords=] are:
14521462

14531463
* <dfn value for="color()">x</dfn>, <dfn value for="color()">y</dfn>, <dfn value for="color()">z</dfn> are all <<number>>s
14541464
that correspond to the [=origin color's=] X, Y and Z channels
1455-
after its conversion to relative CIE XYZ color space
1465+
after <a href="#required-conversion">conversion, if required</a> to relative CIE XYZ color space
14561466
adapted to the relevant white point.
14571467

14581468
The parameters have the following form:
@@ -2871,7 +2881,7 @@ No new privacy considerations have been reported on this specification.
28712881
<li>Fixed a typo in definition of rgb()</li>
28722882
<li>Editorial improvements (capitalization, spelling, clarity)</li>
28732883
<li>Exported definitions for other specifications to use</li>
2874-
<li> Add missing 'none' to alpha in grammar of color()</li>
2884+
<li> Add missing ''none'' to alpha in grammar of color()</li>
28752885
<li>Moved the color-contrast() function to level 6</li>
28762886
</ul>
28772887

0 commit comments

Comments
 (0)