Skip to content

Commit 7835149

Browse files
committed
]css-color-4] Explicitly note the presence or absence of legacy color syntax for each form, see #6911
1 parent 73f63f0 commit 7835149

File tree

1 file changed

+33
-15
lines changed

1 file changed

+33
-15
lines changed

css-color-4/Overview.bs

Lines changed: 33 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1494,16 +1494,16 @@ The RGB functions: ''rgb()'' and ''rgba()''</h3>
14941494
but are clamped to the ranges defined here at computed-value time.
14951495

14961496
For legacy reasons,
1497-
''rgb()'' also supports an alternate syntax
1497+
''rgb()'' also supports a <a>legacy color syntax</a>
14981498
that separates all of its arguments with commas:
14991499

15001500
<pre class='prod'>
15011501
rgb() = rgb( <<percentage>>#{3} , <<alpha-value>>? ) |
15021502
rgb( <<number>>#{3} , <<alpha-value>>? )
15031503
</pre>
15041504

1505-
Also for legacy reasons,
1506-
an <dfn>rgba()</dfn> function also exists,
1505+
Also,
1506+
an <dfn>rgba()</dfn> <a>legacy color syntax</a> also exists,
15071507
with an identical grammar and behavior to ''rgb()''.
15081508

15091509
<wpt>
@@ -2401,15 +2401,15 @@ HSL Colors: ''hsl()'' and ''hsla()'' functions</h2>
24012401
</div>
24022402

24032403
For legacy reasons,
2404-
''hsl()'' also supports an alternate syntax
2404+
''hsl()'' also supports a <a>legacy color syntax</a>
24052405
that separates all of its arguments with commas:
24062406

24072407
<pre class='prod'>
24082408
hsl() = hsl( <<hue>>, <<percentage>>, <<percentage>>, <<alpha-value>>? )
24092409
</pre>
24102410

2411-
Also for legacy reasons,
2412-
an <dfn>hsla()</dfn> function also exists,
2411+
Also,
2412+
an <dfn>hsla()</dfn> <a>legacy color syntax</a> also exists,
24132413
with an identical grammar and behavior to ''hsl()''.
24142414

24152415
<wpt>
@@ -2798,8 +2798,9 @@ HWB Colors: ''hwb()'' function</h2>
27982798
without any hint of the chosen hue.
27992799
In this case, the hue component is [=powerless=].
28002800

2801-
There is no legacy with ''hwb'', and so
2802-
''hwb()'' does <em>not</em> support an alternate syntax
2801+
There is no Web compatibility issue
2802+
with ''hwb'', which is new in this level of the specification, and so
2803+
''hwb()'' does <em>not</em> support a <a>legacy color syntax</a>
28032804
that separates all of its arguments with commas.
28042805
Using commas inside ''hwb()'' is an error.
28052806

@@ -3439,6 +3440,12 @@ Specifying Lab and LCH: the ''lab()'' and ''lch()'' functional notations</h3>
34393440
</pre>
34403441
</div>
34413442

3443+
There is no Web compatibility issue
3444+
with ''lab'' or ''lch''', which are new in this level of the specification, and so
3445+
''lab()'' and ''lch()'' do <em>not</em> support a <a>legacy color syntax</a>
3446+
that separates all of their arguments with commas.
3447+
Using commas inside these functions is an error.
3448+
34423449
<h3 id="specifying-oklab-oklch">
34433450
Specifying OKLab and OKLCH: the ''oklab()'' and ''oklch()'' functional notations</h3>
34443451

@@ -3553,6 +3560,12 @@ Specifying Lab and LCH: the ''lab()'' and ''lch()'' functional notations</h3>
35533560
</pre>
35543561
</div>
35553562

3563+
There is no Web compatibility issue
3564+
with ''oklab'' or ''oklch''', which are new in this level of the specification, and so
3565+
''oklab()'' and ''oklch()'' do <em>not</em> support a <a>legacy color syntax</a>
3566+
that separates all of their arguments with commas.
3567+
Using commas inside these functions is an error.
3568+
35563569

35573570
<h3 id='lab-to-lch'>
35583571
Converting Lab or OKLab colors to LCH or OKLCH colors</h3>
@@ -3618,13 +3631,13 @@ Predefined Color Spaces</h2>
36183631

36193632

36203633
<!--
3621-
██████ ███████ ██ ███████ ████████ ███ ███
3622-
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
3623-
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
3624-
██ ██ ██ ██ ██ ██ ████████ ██ ██
3625-
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
3626-
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
3627-
██████ ███████ ████████ ███████ ██ ██ ███ ███
3634+
██████ ███████ ██ ███████ ████████ ███ ███
3635+
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
3636+
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
3637+
██ ██ ██ ██ ██ ██ ████████ ██ ██
3638+
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
3639+
██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██
3640+
██████ ███████ ████████ ███████ ██ ██ ███ ███
36283641
-->
36293642

36303643
<h3 id="color-function">Specifying predefined colors: the ''color()'' function</h3>
@@ -3718,6 +3731,11 @@ Predefined Color Spaces</h2>
37183731
This is interpreted the same way as the <<alpha-value>> in ''rgb()'',
37193732
and if omitted it defaults to ''100%''.
37203733

3734+
There is no Web compatibility issue
3735+
with ''color()'', which is new in this level of the specification, and so
3736+
''color()'' does <em>not</em> support a <a>legacy color syntax</a>
3737+
that separates all of its arguments with commas.
3738+
Using commas inside this function is an error.
37213739

37223740
A color which is either an [=invalid color=] or
37233741
an [=out of gamut=] color

0 commit comments

Comments
 (0)