Skip to content

Commit 74bd678

Browse files
committed
Add note about comparing computed values.
1 parent 9288ddb commit 74bd678

1 file changed

Lines changed: 23 additions & 11 deletions

File tree

css3-values/Overview.src.html

Lines changed: 23 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1096,17 +1096,29 @@ <h3 id="toggle-notation">
10961096
Note that values with commas at the top-level
10971097
will be incorrectly interpreted as separate values.
10981098

1099-
<p>The value returned by ''toggle()'' must be determined by comparing
1100-
the inherited value <var>I</var> (the computed value on the parent,
1101-
or, for the root, the initial value) to the computed values
1102-
<var>C<sub>n</sub></var> returned by the <var>n</var>-th argument to
1103-
''toggle()''.
1104-
For the earliest <var>C<sub>n</sub></var> such that
1105-
<var>C<sub>n</sub></var> = <var>I</var>, the value returned by toggle
1106-
is <var>C<sub>n+1</sub></var>. However, if this <var>C<sub>n</sub></var>
1107-
is the last value, or if there are no <var>C<sub>n</sub></var> that
1108-
equal <var>I</var>, the computed value of the first value is returned
1109-
instead.</p>
1099+
<p>
1100+
The value returned by ''toggle()'' must be determined
1101+
by comparing the inherited value <var>I</var>
1102+
(the computed value on the parent,
1103+
or, for the root, the initial value)
1104+
to the computed values <var>C<sub>n</sub></var> returned by the <var>n</var>-th argument to ''toggle()''.
1105+
For the earliest <var>C<sub>n</sub></var>
1106+
such that <var>C<sub>n</sub></var> = <var>I</var>,
1107+
the value returned by toggle is <var>C<sub>n+1</sub></var>.
1108+
However, if this <var>C<sub>n</sub></var> is the last value,
1109+
or if there are no <var>C<sub>n</sub></var> that equal <var>I</var>,
1110+
the computed value of the first value is returned instead.
1111+
1112+
<p class='note'>
1113+
Note that "computed values" are abstract sets of values,
1114+
not particular serializations,
1115+
so comparison between computed values should always be unambiguous and have the expected result.
1116+
For example,
1117+
'box-shadow' computed values are just two offsets, a blur, a spread, and a color,
1118+
so the declarations ''box-shadow: 1px 1px blue;'' and ''box-shadow: 1px 1px 0px blue;''
1119+
produce identical computed values.
1120+
If the "Computed Value" line of a property definition seems to define something ambiguous or overly strict,
1121+
please <a href="#status">provide feedback</a> so we can fix it.
11101122

11111123
<p class='note'>Note that ''toggle()'' explicitly looks at the computed value
11121124
of the parent, so it is useful even for non-inherited properties. This

0 commit comments

Comments
 (0)