Skip to content

Commit fd00815

Browse files
committed
[css-properties-values] Simplify the Conditional Rules section a bit.
1 parent c6b60a3 commit fd00815

File tree

1 file changed

+18
-18
lines changed

1 file changed

+18
-18
lines changed

css-properties-values-api/Overview.bs

+18-18
Original file line numberDiff line numberDiff line change
@@ -338,24 +338,24 @@ which can start or interrupt a CSS transition.
338338
Conditional Rules {#conditional-rules}
339339
--------------------------------------
340340

341-
Unregistered custom properties are “always valid”
342-
when tested via ''@supports'';
343-
a rule like `@supports (--foo: red) {...}`
344-
is always true
345-
so long as you don't violate the (very liberal) syntax for custom properties.
346-
347-
Registering a custom property does not change this.
348-
Even if a custom property is, for example,
349-
registered with `syntax: "<color>"`,
350-
a rule like `@supports (--foo: 1em) {...}`
351-
will still evaluate as true and apply those styles.
352-
353-
Note: This matches the [[#parsing-custom-properties|parsing behavior]] of registered custom properties.
354-
A registered custom property specified as `"<color>"`
355-
but written as `--foo: 1em;` will still be accepted as valid at parse-time,
356-
but be automatically [=invalid at computed-value time=].
357-
As ''@supports'' tests parsing behavior,
358-
it thus also accepts all values as valid regardless of the registered syntax.
341+
As stated in [[#parsing-custom-properties]],
342+
both unregistered and [=registered=] [=custom properties=]
343+
accept (almost) all possible values at parse-time.
344+
[=Registered=] [=custom properties=] only apply their syntax at [=computed value=] time.
345+
346+
So, all [=custom properties=],
347+
regardless of whether they're [=registered=] or unregistered,
348+
will test as "true" in an ''@supports'' rule,
349+
so long as you don't violate the (very liberal) generic syntax for [=custom properties=].
350+
351+
<div class=example>
352+
For example,
353+
even if a custom property is registered
354+
with <code highlight=css>syntax: "&lt;color>";</code>,
355+
a rule like `@supports (--foo: 1em) {...}`
356+
will still evaluate as true and apply those styles,
357+
because the declaration <em>does</em> successfully parse as a valid property.
358+
</div>
359359

360360

361361
Substitution via ''var()'' {#substitution}

0 commit comments

Comments
 (0)