Skip to content

Commit 04a3b0d

Browse files
committed
[css-typed-om] We should be talking about "declared" style not "specified" style.
Fixed #355.
1 parent bb99132 commit 04a3b0d

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

css-typed-om/Overview.bs

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ Some particular considerations:
6767
* retrieved JavaScript representations of CSS values are not mutable - instead updates
6868
must explicitly be set using the API.
6969
* objects are organized for consistency rather than ease of access. For example, even
70-
though lengths are often numeric pixel values, a specified {{CSSLengthValue}} can't be
70+
though lengths are often numeric pixel values, a declared {{CSSLengthValue}} can't be
7171
treated as a number without first explicitly casting it to a {{CSSSimpleLength}}, as calc
7272
expressions and keywords are also valid lengths.
7373

@@ -146,7 +146,7 @@ which is a list of property - sequence<{{CSSStyleValue}}> pairs. This list
146146
is initialized differently depending on where the {{CSSStyleValue}} is used
147147
(see
148148
[[#computed-stylepropertymapreadonly-objects]],
149-
[[#specified-stylepropertymap-objects]], and
149+
[[#declared-stylepropertymap-objects]], and
150150
[[#inline-stylepropertymap-objects]]).
151151

152152
<div class='note'>
@@ -232,7 +232,7 @@ Note: The StylePropertyMap returned by getComputedStyleMap represents computed s
232232
not resolved style. In this regard it provides different values than those
233233
in objects returned by getComputedStyle.
234234

235-
Specified {{StylePropertyMap}} objects {#specified-stylepropertymap-objects}
235+
Declared {{StylePropertyMap}} objects {#declared-stylepropertymap-objects}
236236
----------------------------------------------------------------------------
237237

238238
<pre class='idl'>
@@ -241,11 +241,11 @@ partial interface CSSStyleRule {
241241
};
242242
</pre>
243243

244-
<dfn>Specified StylePropertyMap</dfn> objects represent style property-value pairs embedded
244+
<dfn>Declared StylePropertyMap</dfn> objects represent style property-value pairs embedded
245245
in a style rule, and are accessed via the <dfn attribute for=CSSStyleRule>styleMap</dfn>
246246
attribute of {{CSSStyleRule}} objects.
247247

248-
When constructed, the <a>property model</a> for <a>specified StylePropertyMap</a>
248+
When constructed, the <a>property model</a> for <a>declared StylePropertyMap</a>
249249
objects is initialized to contain
250250
an entry for each property that is paired with at least one valid value inside the
251251
{{CSSStyleRule}} that the object represents. The value for a given property is
@@ -317,7 +317,7 @@ interface CSSNumberValue : CSSStyleValue {
317317
{{CSSNumberValue}} objects represent values for simple number-valued properties like 'z-index' or 'opacity'.
318318

319319
{{CSSNumberValue}} objects are not range-restricted. Any valid number can be represented by a {{CSSNumberValue}},
320-
and that value will not be clamped, rounded, or rejected when set on a <a>specified StylePropertyMap</a> or
320+
and that value will not be clamped, rounded, or rejected when set on a <a>declared StylePropertyMap</a> or
321321
<a>inline StylePropertyMap</a>. Instead, clamping and/or rounding will occur during computation of style.
322322

323323
<div class='example'>
@@ -420,7 +420,7 @@ interface CSSSimpleLength : CSSLengthValue {
420420
"calc(56em + 10%)").
421421

422422
{{CSSLengthValue}} objects are not range-restricted. Any valid combination of primitive lengths can be represented by a {{CSSLengthValue}},
423-
that value will be accepted unaltered when set on a <a>specified StylePropertyMap</a> or
423+
that value will be accepted unaltered when set on a <a>declared StylePropertyMap</a> or
424424
<a>inline StylePropertyMap</a>. Instead, clamping and/or rounding will occur during computation of style.
425425

426426
Note that lengths which incorporate variable references will instead be represented as
@@ -1106,7 +1106,7 @@ appear as computed values (i.e. as a value stored on computed
11061106
Computed {{CSSUnparsedValue}} objects {#computed-unparsedvalue-objects}
11071107
-----------------------------------------------------------------------------
11081108

1109-
A property with a specified {{CSSUnparsedValue}} value will not
1109+
A property with a declared {{CSSUnparsedValue}} value will not
11101110
compute to a {{CSSUnparsedValue}}. Instead, after custom property references
11111111
are resolved, the {{CSSStyleValue}} subclass appropriate to the property will be
11121112
used.
@@ -1118,7 +1118,7 @@ For example, a style rule containing:
11181118
width: calc(var(--foo) + 10%);
11191119
</pre>
11201120

1121-
Will represent a specified width as an {{CSSUnparsedValue}}, but if this value
1121+
Will represent a declared width as an {{CSSUnparsedValue}}, but if this value
11221122
is the winning value during computation for a given element then that element's
11231123
computed width will be represented by a {{CSSLengthValue}} object (assuming
11241124
that --foo resolves to a valid substitution).
@@ -1136,7 +1136,7 @@ For example, a style rule containing:
11361136
--foo: var(--bar) black;
11371137
</pre>
11381138

1139-
Will represent a specified value for --foo as a {{CSSUnparsedValue}}, and if
1139+
Will represent a declared value for --foo as a {{CSSUnparsedValue}}, and if
11401140
this value is the winning declaration for --foo during computation for a given
11411141
element, then that element's will have a computed value for --foo that is
11421142
represented by a {{CSSStyleValue}}.

0 commit comments

Comments
 (0)