Skip to content

Commit 66347f9

Browse files
committed
[css-typed-om] Add parseAll alongside parse.
(Addresses w3c#311)
1 parent fc050f9 commit 66347f9

File tree

1 file changed

+22
-7
lines changed

1 file changed

+22
-7
lines changed

css-typed-om/Overview.bs

Lines changed: 22 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -108,7 +108,8 @@ Some particular considerations:
108108
<pre class='idl'>
109109
interface CSSStyleValue {
110110
readonly attribute DOMString cssText;
111-
static (CSSStyleValue or sequence&lt;CSSStyleValue>)? parse(DOMString property, DOMString cssText);
111+
static CSSStyleValue? parse(DOMString property, DOMString cssText);
112+
static sequence&lt;CSSStyleValue>? parseAll(DOMString property, DOMString cssText);
112113
};
113114
</pre>
114115

@@ -122,10 +123,17 @@ returns a normalized representation
122123
(see [[#stylevalue-normalization]])
123124
of the value the {{CSSStyleValue}} object represents.
124125

126+
The <dfn method for=CSSStyleValue>parse(DOMString <var>property</var>, DOMString <var>cssText</var>)</dfn>,
127+
when invoked, must [=parse a CSSStyleValue=] with property <var>property</var>, cssText <var>cssText</var>,
128+
and parseMultiple set to false.
129+
130+
The <dfn method for=CSSStyleValue>parseAll(DOMString <var>property</var>, DOMString <var>cssText</var>)</dfn>,
131+
when invoked, must [=parse a CSSStyleValue=] with property <var>property</var>, cssText <var>cssText</var>,
132+
and parseMultiple set to true.
133+
125134
<div algorithm="parse a CSSStyleValue">
126-
The <dfn method for=CSSStyleValue>parse(DOMString <var>property</var>, DOMString <var>cssText</var>)</dfn>,
127-
when invoked,
128-
must run these steps:
135+
To <dfn>parse a CSSStyleValue</dfn> given a <var>property</var>, <var>cssText</var>, and a
136+
<var>parseMultiple</var> flag, run these steps:
129137

130138
1. Attempt to parse |property| as an <<ident>>.
131139
If this fails,
@@ -143,12 +151,19 @@ of the value the {{CSSStyleValue}} object represents.
143151
Otherwise,
144152
let |value| be the parsed result.
145153

146-
4. If |property| is a [=list-valued property=],
154+
4. If |property| is a [=list-valued property=], and |parseMultiple| is true,
147155
subdivide |value| into a list of {{CSSStyleValue}} objects,
148156
each representing one [=list-valued property iteration=],
149-
and let |value| be the result.
157+
and let |value| be the result. Return |value| as a sequence of
158+
{{CSSStyleValue}} objects.
159+
160+
5. If |property| is a [=list-valued property=], and |parseMultiple| is false
161+
subdivide |value| into a list of {{CSSStyleValue}} objects,
162+
each representing one [=list-valued property iteration=],
163+
and let |value| be the first entry in this list.
164+
165+
6. return a {{CSSStyleValue}} representing |value|.
150166

151-
5. Return a {{CSSStyleValue}} representing |value|.
152167
</div>
153168

154169
<!--

0 commit comments

Comments
 (0)