Skip to content

Commit 16de992

Browse files
committed
[css-color-5][editorial] markup fixes for bikeshed
1 parent 0658a54 commit 16de992

File tree

1 file changed

+17
-12
lines changed

1 file changed

+17
-12
lines changed

css-color-5/Overview.bs

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -95,9 +95,13 @@ Lastly, compatibility with legacy Web content may be the most important consider
9595
<dfn>&lt;color-space></dfn> = srgb | hsl | hwb | xyz | lab | lch
9696
</pre>
9797

98+
<p dfn-type=value dfn-for="<color-space>">
99+
The <dfn>srgb</dfn>, <dfn>hsl</dfn>, <dfn>hwb</dfn>, <dfn>xyz</dfn>, <dfn>lab</dfn>, and <dfn>lch</dfn> keywords
100+
each refer to their corresponding color space.
101+
98102
When no <<color-space>> is specified,
99103
the mixing is done in the ''lch'' color space.
100-
The [=xyz=] color space is CIE XYZ, with a D50 whitepoint, and allows computation to be done
104+
The ''xyz'' color space is CIE XYZ, with a D50 whitepoint, and allows computation to be done
101105
in a linear-light-intensity space.
102106

103107

@@ -542,15 +546,16 @@ Selecting the most contrasting color: the ''color-contrast()'' function {#colorc
542546
to the single color.
543547

544548
The single color is separated from the list
545-
with the keyword 'vs'
549+
with the keyword <css>vs</css>
546550
and the target contrast, if present, is separated from the list
547-
with the keyword 'to'.
551+
with the keyword <css>to</css>.
548552

549553
<pre class='prod'>
550554
<dfn>color-contrast()</dfn> = color-contrast( <<color>> vs <<color>>#{2,} [ to [<<number>> | AA | AA-large]]? )
551555
</pre>
552556

553-
The keyword 'AA' is equivalent to 4.5, and the keyword 'AA-large' is equivalent to 3.
557+
The keyword <dfn value for="color-contrast()">AA</dfn> is equivalent to ''4.5'',
558+
and the keyword <dfn value for="color-contrast()">AA-large</dfn> is equivalent to ''3''.
554559

555560
<div class="example">
556561
<pre class="lang-css">color-contrast(wheat vs tan, sienna, var(--myAccent), #d2691e)</pre>
@@ -612,7 +617,7 @@ Selecting the most contrasting color: the ''color-contrast()'' function {#colorc
612617

613618
If there is a target contrast,
614619
and the end of the list is reached without meeting that target,
615-
either 'white' or 'black' is returned,
620+
either ''white'' or ''black'' is returned,
616621
whichever has the higher contrast.
617622

618623
<div class="example">
@@ -716,27 +721,27 @@ Adjusting colors: the ''color-adjust'' function {#coloradjust}
716721
</pre>
717722

718723
The meaning of the adjusters is defined by color space.
719-
For example, if the <<color-space>> is [=hsl=],
724+
For example, if the <<color-space>> is ''hsl'',
720725
hue means the HSL hue, which is not the same as the LCH hue;
721-
if the color space is [=lch=],
726+
if the color space is ''lch'',
722727
lightness means the LCH Lightness, which is the same as Lab lightness,
723728
but different to the HSL Lightness.
724729

725-
Only the [=color-adjuster=]s defined for a given <<color-space>> are available.
726-
For example, it is not possible to use the HWB [=whiteness=] adjuster unless the color space is [=hwb=].
730+
Only the <<color-adjuster>>s defined for a given <<color-space>> are available.
731+
For example, it is not possible to use the HWB ''whiteness'' adjuster unless the color space is ''hwb''.
727732
The alpha adjuster is available on any <<color-space>>.
728733

729-
Note: not all [=color-adjuster=]s are equally useful.
734+
Note: not all <<color-adjuster>>s are equally useful.
730735
Adjustments in LCH are the most useful, which is why it is the default.
731736
Adjustments on the a and b axes are rarely needed.
732-
Adjustments in the srgb-related spaces (srgb itself, hsl, hwb)
737+
Adjustments in the srgb-related spaces (''srgb'' itself, ''hsl'', ''hwb'')
733738
are provided mainly for backward compatibility
734739
with the sorts of adjustments currently done in CSS preprocessors.
735740
Adjusting the individual x, y and z channels will produce significant hue shifts;
736741
however, adjusting all three channels together is useful
737742
and will lighten or darken the color.
738743

739-
The [=hue-adjuster=] takes optional keywords, to specify the [[css-color-4#hue-interpolation]] algorithm.
744+
The <<hue-adjuster>> takes optional keywords, to specify the [[css-color-4#hue-interpolation]] algorithm.
740745
If no keyword is specified, it is as if ''shorter'' were specified.
741746

742747
<div class="example">

0 commit comments

Comments
 (0)