@@ -19,15 +19,31 @@ Introduction {#intro}
1919
2020 <em> This section is not normative.</em>
2121
22- Authors frequently need to set a property to different values based
23- on the relation between certain values.
22+ Note: This section is a stub and needs to be expanded.
2423
25- For example, a web component may support several keyword-based custom properties
26- and may want to set several different property values based on each keyword value .
24+ Authors frequently need to set a property to different values based
25+ on the relation between certain values.
2726
28- As another example, ...
2927
30- Note: TODO expand motivation
28+ High level custom properties {#high-level-custom-properties}
29+ -----------------------------
30+
31+ A web component may support several custom properties which
32+ do not contain a value fragment verbatim, but set several properties across multiple rules indirectly.
33+ For example, a `--size` property with values `small`, `medium`, `large`,
34+ or an `--alignment` property with values `horizontal` and `vertical`.
35+
36+
37+ Relation between units of the same type {#relation-between-units}
38+ ---------------------------------------
39+
40+ Author code often needs to branch based on the relation between different units of the same type.
41+
42+ For example:
43+
44+ * Comparing viewport and absolute units allows compact one-off viewport dimension media queries
45+ * Comparing font-relative units and absolute <<length>> units allows authors
46+ to apply different styling for small and large font sizes, enhancing readability.
3147
3248Value Definitions {#values}
3349---------------------------
@@ -65,6 +81,9 @@ Logical comparisons: The <<condition>> type {#condition}
6581 <dfn><comparison-operator></dfn> = [ '=' | '>=' | '>' | '<' | '<=' ]
6682</pre>
6783
84+ Note: A future version of this module may expand <<comparison-operand>>
85+ to complex types, such as colors.
86+
6887<<condition>> values are logical expressions that resolve to a <<boolean-constant>>
6988by performing simple comparisons and following basic boolean operators.
7089When using `and` or `or` operators, precedence must be enforced with parentheses.
0 commit comments