10 |
<div class="header"> |
<div class="header"> |
11 |
<h1>Selectors Serialization Format for Testing (<abbr>SSFT</abbr>) |
<h1>Selectors Serialization Format for Testing (<abbr>SSFT</abbr>) |
12 |
Specification</h1> |
Specification</h1> |
13 |
<h2>Working Draft <time datetime=2007-10-22>22 October 2007</time></h2> |
<h2>Working Draft <time datetime=2007-10-28>28 October 2007</time></h2> |
14 |
|
|
15 |
<dl class="versions-uri"> |
<dl class="versions-uri"> |
16 |
<dt>This Version</dt> |
<dt>This Version</dt> |
98 |
<abbr>API</abbr></a> |
<abbr>API</abbr></a> |
99 |
<cite class="bibref informative">[<a href="#ref-SAPI">SAPI</a>]</cite>.</p> |
<cite class="bibref informative">[<a href="#ref-SAPI">SAPI</a>]</cite>.</p> |
100 |
|
|
101 |
<div class="issue ed">...</div> |
<p>It is so flexible language that a conceptually same pattern |
102 |
|
can be represented in inifnite numbers of instances of selectors. |
103 |
|
It might be convinient for e.g. validation of a test result to |
104 |
|
define a subset of the language, in which no semantically equivalent |
105 |
|
selectors are contained.</p> |
106 |
|
|
107 |
<p><a href="http://dev.w3.org/cvsweb/csswg/cssom/Overview.html">The |
<p><a href="http://dev.w3.org/cvsweb/csswg/cssom/Overview.html">The |
108 |
<abbr title="Cascading Style Sheets Object Model">CSSOM</abbr> |
<abbr title="Cascading Style Sheets Object Model">CSSOM</abbr> |
115 |
<time datetime=2007-09-25>at the time of the writing</time>. |
<time datetime=2007-09-25>at the time of the writing</time>. |
116 |
Note that current Web browser implementations |
Note that current Web browser implementations |
117 |
of the <code>selectorText</code> attribute are consistently broken |
of the <code>selectorText</code> attribute are consistently broken |
118 |
in not escaping unsafe identifiers.</p> |
in not escaping unsafe identifiers and therefore it is not wise |
119 |
|
to deploy that format for testing.</p> |
120 |
|
|
121 |
</div> |
</div> |
122 |
|
|
133 |
2119</a> |
2119</a> |
134 |
<cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p> |
<cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p> |
135 |
|
|
136 |
|
<p>Requirements phrased in the imperative as part of algorithms are to be |
137 |
|
interpreted with the meaning of the key word (<em class=rfc2119>MUST</em>) |
138 |
|
used in introducing the algorithm.</p> |
139 |
|
|
140 |
|
<p>Conformance requirements phrased as algorithms or specific steps |
141 |
|
<em class=rfc2119>MAY</em> be implemented in any manner, so long as the end |
142 |
|
result is equivalent.</p> |
143 |
|
|
144 |
<!-- Strictly speaking the paragraph below is not part of terminology. --> |
<!-- Strictly speaking the paragraph below is not part of terminology. --> |
145 |
<p>All examples and notes in this specification are non$B!>(Bnormative, |
<p>All examples and notes in this specification are non$B!>(Bnormative, |
146 |
as are all sections explicitly marked non$B!>(Bnormative. Everything |
as are all sections explicitly marked non$B!>(Bnormative. Everything |
153 |
</div> |
</div> |
154 |
|
|
155 |
<div class="section" id="serializing"> |
<div class="section" id="serializing"> |
156 |
<h2>Serializing Selectors as |
<h2>Serializing Selectors in |
157 |
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
158 |
Representation</h2> |
Representation</h2> |
159 |
|
|
160 |
|
<p>Subsections of this section define algorithms |
161 |
|
to <a href="#algorithm-serialize-a-simple-selector">serialize a simple |
162 |
|
selector</a> or <a href="#algorithm-serialize-a-group-of-selectors">serialize |
163 |
|
a group of selectors</a>.</p> |
164 |
|
|
165 |
<div class="issue ed"> |
<div class="issue ed"> |
166 |
<p><a href="http://suika.fam.cx/gate/cvs/*checkout*/markup/html/whatpm/Whatpm/CSS/SelectorsSerializer.pm">See the reference implementation</a> |
<p><a href="http://suika.fam.cx/gate/cvs/*checkout*/markup/html/whatpm/Whatpm/CSS/SelectorsSerializer.pm">See |
167 |
for now.</p> |
also the reference implementation</a> for now.</p> |
168 |
|
</div> |
169 |
|
|
170 |
|
<div class="note memo"> |
171 |
|
<p>The serialized representation will not contain any comment.</p> |
172 |
</div> |
</div> |
173 |
|
<!-- TODO: link terms to Selectors --> |
174 |
|
|
175 |
<div class=section id=serializing-tokens> |
<div class=section id=serializing-tokens> |
176 |
<h3>Serializing Tokens</h3> |
<h3>Serializing Tokens</h3> |
177 |
|
|
178 |
<p>To <dfn id=algorithm-normalize-an-ident title="normalize an IDENT">normalize |
<p>To <dfn id=algorithm-normalize-an-ident title="normalize a string as an IDENT">normalize |
179 |
an <code>IDENT</code> (<dfn id=var-n><var>n</var></dfn>)</dfn>:</p> |
a string (<dfn id=var-n><var>n</var></dfn>) as an <code>IDENT</code></dfn>, |
180 |
|
the following algorithm <em class=rfc2119>MUST</em> be used:</p> |
181 |
<ol> |
<ol> |
182 |
<li>Replace the escape sequences (<code>\</code> and following |
<li>If <var>n</var> is either an <code>IDENT</code> or a <code>HASH</code>, |
183 |
characters) in <var>n</var> by characters represented by them |
replace the escape sequences (<code>\</code> and following characters) in |
184 |
respectively.</li> |
<var>n</var> by characters represented by them respectively.</li> |
185 |
|
<li>If <var>n</var> is a <code>HASH</code>, remove the leading |
186 |
|
<code class=char>U+0023</code> <code class=charname>NUMBER SIGN</code> |
187 |
|
(<code class=char>#</code>) character from <var>n</var>.</li> |
188 |
<li>If there is any character that is <em>not</em> one of |
<li>If there is any character that is <em>not</em> one of |
189 |
<code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code> |
<code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code> |
190 |
(<code class=char>-</code>), <code class=char>U+0030</code> |
(<code class=char>-</code>), <code class=char>U+0030</code> |
234 |
<li>Then, <var>n</var> is the result of the algorithm.</li> |
<li>Then, <var>n</var> is the result of the algorithm.</li> |
235 |
</ol> |
</ol> |
236 |
|
|
237 |
<p>To <dfn id=algorithm-normalize-a-string title="normalize a STRING">normalize |
<p>To <dfn id=algorithm-normalize-a-string title="normalize a string (STRING or IDENT) as a STRING">normalize |
238 |
a <code>STRING</code> (<dfn id=var-s><var>s</var></dfn>)</dfn>:</p> |
a string (<dfn id=var-s><var>s</var></dfn>) as a <code>STRING</code></dfn>, |
239 |
|
the following algorithm <em class=rfc2119>MUST</em> be used:</p> |
240 |
<ol> |
<ol> |
241 |
<li><p>Replace the escape sequences (<code>\</code> and following |
<li>If <var>s</var> is either an <code>IDENT</code> or a |
242 |
characters) in <var>s</var> by characters represented by them |
<code>STRING</code>, replace the escape sequences (<code>\</code> and |
243 |
|
following characters) in <var>s</var> by characters represented by them |
244 |
(or an empty string if <code>\</code> is immediately followed by |
(or an empty string if <code>\</code> is immediately followed by |
245 |
newline character(s)) respectively.</p></li> |
newline character(s)) respectively.</li> |
246 |
<li><p>Remove the quotation characters in <var>s</var> |
<li>If <var>s</var> is a <code>STRING</code>, remove the quotation marks |
247 |
if <var>s</var> is a <code>STRING</code>.</p> |
enclosing <var>s</var>.</li> |
|
|
|
|
<div class="note memo"> |
|
|
<p>The input <var>s</var> to this algorithm may be an |
|
|
<code>IDENT</code>.</p> |
|
|
</div></li> |
|
248 |
<li><p>If there is any character that is <em>not</em> one of |
<li><p>If there is any character that is <em>not</em> one of |
249 |
<code class=char>U+0020</code> <code class=charname>SPACE</code>, |
<code class=char>U+0020</code> <code class=charname>SPACE</code>, |
250 |
<code class=char>U+0021</code> <code class=charname>EXCLAMATION MARK</code> |
<code class=char>U+0021</code> <code class=charname>EXCLAMATION MARK</code> |
291 |
representations are literally compared.</p> |
representations are literally compared.</p> |
292 |
</div> |
</div> |
293 |
|
|
294 |
|
<div class="issue ed"> |
295 |
|
<p>Need to define <dfn id=lower-case>lower$B!>(Bcase</dfn>. |
296 |
|
It is tr/A-Z/a-z/ for now.</p> |
297 |
|
</div> |
298 |
|
|
299 |
</div> |
</div> |
300 |
|
|
301 |
|
|
302 |
<div class=section id=serializing-simple-selectors> |
<div class=section id=serializing-simple-selectors> |
303 |
<h3>Serializing Simple Selectors</h3> |
<h3>Serializing Simple Selectors</h3> |
304 |
|
|
305 |
|
<p>No <abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
306 |
|
representation is defined for an invalid <a href="#simple-selector">simple |
307 |
|
selector</a>.</p> |
308 |
|
|
309 |
<p>To |
<p>To |
310 |
<dfn id=algorithm-serialize-a-simple-selector title="serialize a simple selector">serialize |
<dfn id=algorithm-serialize-a-simple-selector title="serialize a simple selector">serialize |
311 |
a simple selector (<dfn><var id=var-ss>ss</var></dfn>)</dfn>:</p> |
a simple selector (<dfn><var id=var-ss>ss</var></dfn>)</dfn>, |
312 |
|
the following algorithm <em class=rfc2119>MUST</em> be used:</p> |
313 |
|
<ol> |
314 |
|
<li>Let <dfn id=var-r><var>r</var></dfn> an empty string.</li> |
315 |
|
<li>Process <var>ss</var> as following: |
316 |
|
|
317 |
<dl class=switch> |
<dl class=switch> |
318 |
<dt>If <var>ss</var> is a type or universal selector</dt> |
<dt>If <var>ss</var> is a type or universal selector</dt> |
319 |
<dd> |
<dd> |
320 |
<ol> |
<ol> |
321 |
<li> |
<li>Append a namespace prefix as following: |
322 |
|
|
323 |
<dl class=switch> |
<dl class=switch> |
324 |
<dt>If a namespace URI is specified (via namespace prefix, or |
<dt>If a namespace URI is specified (via namespace prefix, or |
325 |
by omitting namespace prefix where a default namespace is specified)</dt> |
by omitting namespace prefix where a default namespace is specified)</dt> |
326 |
<dd class="ed">@@</dd> |
<dd>Append the namespace URI as a |
327 |
|
<a href="#algorithm-normalize-an-ident" title="normalize a string as an IDENT">normalized |
328 |
|
<code>IDENT</code></a> to <var>r</var>. Then, append a |
329 |
|
<code class=char>U+007C</code> |
330 |
|
<code class=charname>VERTICAL BAR</code> (<code class=char>|</code>) |
331 |
|
character to <var>r</var>.</dd> |
332 |
<dt>If the null namespace is specified (by zero$B!>(Blength namespace |
<dt>If the null namespace is specified (by zero$B!>(Blength namespace |
333 |
prefix)</dt> |
prefix)</dt> |
334 |
<dd>Append a <code class=char>U+007C</code> |
<dd>Append a <code class=char>U+007C</code> |
335 |
<code class=charname>VERTICAL BAR</code> (<code class=char>|</code>) |
<code class=charname>VERTICAL BAR</code> (<code class=char>|</code>) |
336 |
character to <var>result</var>.</dd> |
character to <var>r</var>.</dd> |
337 |
<dt>If no namespace is specified (by namespace prefix <code>*</code>, |
<dt>If no namespace is specified (by namespace prefix <code>*</code>, |
338 |
or by omitting namespace prefix where no default namespace is |
or by omitting namespace prefix where no default namespace is |
339 |
specified)</dt> |
specified)</dt> |
341 |
<code class=charname>ASTERISK</code> (<code class=char>*</code>) |
<code class=charname>ASTERISK</code> (<code class=char>*</code>) |
342 |
character, followed by a <code class=char>U+007C</code> |
character, followed by a <code class=char>U+007C</code> |
343 |
<code class=charname>VERTICAL BAR</code> (<code class=char>|</code>) |
<code class=charname>VERTICAL BAR</code> (<code class=char>|</code>) |
344 |
character, to <var>result</var>.</dd> |
character, to <var>r</var>.</dd> |
345 |
</dl> |
</dl> |
346 |
</li> |
</li> |
347 |
<li>If <var>ss</var> is a type selector, append the |
<li>If <var>ss</var> is a type selector, append the |
348 |
<a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a> |
<a href="#algorithm-normalize-an-ident" title="normalize a string (IDENT) an IDENT">normalized</a> |
349 |
local name to <var>result</var>.</li> |
local name to <var>r</var>.</li> |
350 |
<li>If <var>ss</var> is a universal selector, append |
<li>If <var>ss</var> is a universal selector, append |
351 |
a <code class=char>U+002A</code> <code class=charname>ASTERISK</code> |
a <code class=char>U+002A</code> <code class=charname>ASTERISK</code> |
352 |
(<code class=char>*</code>) character to <var>result</var>.</li> |
(<code class=char>*</code>) character to <var>r</var>.</li> |
353 |
</ol> |
</ol> |
354 |
</dd> |
</dd> |
355 |
<dt>If <var>ss</var> is an attribute selector</dt> |
<dt>If <var>ss</var> is an attribute selector</dt> |
357 |
<ol> |
<ol> |
358 |
<li>Append a <code class=char>U+005B</code> <code class=charname>LEFT |
<li>Append a <code class=char>U+005B</code> <code class=charname>LEFT |
359 |
SQUARE BRACKET</code> (<code class=char>[</code>) to |
SQUARE BRACKET</code> (<code class=char>[</code>) to |
360 |
<var>result</var>.</li> |
<var>r</var>.</li> |
361 |
<li> |
<li> |
362 |
Append a namespace prefix as following: |
Append a namespace prefix as following: |
363 |
<dl> |
<dl> |
364 |
<dt>If a namespace URI is specified</dt> |
<dt>If a namespace URI is specified</dt> |
365 |
<dd class=ed>@@</dd> |
<dd>Append the namespace URI as a |
366 |
<dd class=ed>@@ Current reference implementation is wrong, |
<a href="#algorithm-normalize-an-ident" title="normalize a string as an IDENT">normalized |
367 |
since its result of sorting depends on namespace prefix.</dd> |
<code>IDENT</code></a> to <var>r</var>. Then, append a |
368 |
|
<code class=char>U+007C</code> |
369 |
|
<code class=charname>VERTICAL BAR</code> (<code class=char>|</code>) |
370 |
|
character to <var>r</var>.</dd> |
371 |
<dt>If the null namespace is specified</dt> |
<dt>If the null namespace is specified</dt> |
372 |
<dd>Append a <code class=char>U+007C</code> |
<dd>Append a <code class=char>U+007C</code> |
373 |
<code class=charname>VERTICAL BAR</code> character to |
<code class=charname>VERTICAL BAR</code> character to |
374 |
<var>result</var>.</dd> |
<var>r</var>.</dd> |
375 |
<dt>If no namespace is specified</dt> |
<dt>If no namespace is specified</dt> |
376 |
<dd>Append a <code class=char>U+002A</code> |
<dd>Append a <code class=char>U+002A</code> |
377 |
<code class=charname>ASTERISK</code> (<code class=char>*</code>) |
<code class=charname>ASTERISK</code> (<code class=char>*</code>) |
378 |
character, followed by a <code class=char>U+007C</code> |
character, followed by a <code class=char>U+007C</code> |
379 |
<code class=charname>VERTICAL BAR</code> (<code class=char>|</code>) |
<code class=charname>VERTICAL BAR</code> (<code class=char>|</code>) |
380 |
character, to <var>result</var>.</dd> |
character, to <var>r</var>.</dd> |
381 |
</dl> |
</dl> |
382 |
</li> |
</li> |
383 |
<li>Append the |
<li>Append the |
384 |
<a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a> |
<a href="#algorithm-normalize-an-ident" title="normalize a string (IDENT) as an IDENT">normalized</a> |
385 |
local name to <var>result</var>.</li> |
local name to <var>r</var>.</li> |
386 |
<li>If a value is specified in <var>ss</var>: |
<li>If a value is specified in <var>ss</var>: |
387 |
<ol> |
<ol> |
388 |
<li>Depending on the way to match, append <code>=</code>, |
<li>Depending on the way to match, append <code>=</code>, |
389 |
<code>~=</code>, <code>|=</code>, <code>^=</code>, |
<code>~=</code>, <code>|=</code>, <code>^=</code>, |
390 |
<code>$=</code>, or <code>*=</code> to <var>result</var>.</li> |
<code>$=</code>, or <code>*=</code> to <var>r</var>.</li> |
391 |
<li>Append the |
<li>Append the |
392 |
<a href="#algorithm-normalize-a-string" title="normalize a string">normalized</a> |
<a href="#algorithm-normalize-a-string" title="normalize a string">normalized</a> |
393 |
value to <var>result</var>.</li> |
value to <var>r</var>.</li> |
394 |
</ol> |
</ol> |
395 |
</li> |
</li> |
396 |
<li>Append a <code class=char>U+005D</code> <code class=charname>RIGHT |
<li>Append a <code class=char>U+005D</code> <code class=charname>RIGHT |
397 |
SQUARE BRACKET</code> (<code class=char>]</code>) to |
SQUARE BRACKET</code> (<code class=char>]</code>) to |
398 |
<var>result</var>.</li> |
<var>r</var>.</li> |
399 |
</ol> |
</ol> |
400 |
</dd> |
</dd> |
401 |
<dt>If <var>ss</var> is a class selector</dt> |
<dt>If <var>ss</var> is a class selector</dt> |
402 |
<dd>Append a <code class=char>U+002E</code> <code class=charname>FULL |
<dd>Append a <code class=char>U+002E</code> <code class=charname>FULL |
403 |
STOP</code> (<code class=char>.</code>) character, followed |
STOP</code> (<code class=char>.</code>) character, followed |
404 |
by <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a> |
by <a href="#algorithm-normalize-an-ident" title="normalize a string (IDENT) as an IDENT">normalized</a> |
405 |
class name, <var>result</var>.</dd> |
class name, to <var>r</var>.</dd> |
406 |
<dt>If <var>ss</var> is an <abbr>ID</abbr> selector</dt> |
<dt>If <var>ss</var> is an <abbr>ID</abbr> selector</dt> |
407 |
<dd>Append a <code class=char>U+0023</code> <code class=charname>NUMBER |
<dd>Append a <code class=char>U+0023</code> <code class=charname>NUMBER |
408 |
SIGN</code> (<code class=char>#</code>) character, followed |
SIGN</code> (<code class=char>#</code>) character, followed |
409 |
by <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a> |
by <a href="#algorithm-normalize-an-ident" title="normalize a string (HASH except for the leading #) as an IDENT">normalized</a> |
410 |
<abbr>ID</abbr>, to <var>result</var>.</dd> |
<abbr>ID</abbr>, to <var>r</var>.</dd> |
411 |
<dt>If <var>ss</var> is a pseudo$B!>(Bclass selector</dt> |
<dt>If <var>ss</var> is a pseudo$B!>(Bclass selector</dt> |
412 |
<dd> |
<dd> |
413 |
<ol> |
<ol> |
414 |
<li>Append a <code class=char>U+003A</code> |
<li>Append a <code class=char>U+003A</code> |
415 |
<code class=charname>COLON</code> (<code class=char>:</code>) character |
<code class=charname>COLON</code> (<code class=char>:</code>) character |
416 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
417 |
<li>Append the |
<li>Append the |
418 |
<a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a> |
<a href="#algorithm-normalize-an-ident" title="normalize a string (IDENT) as an IDENT">normalized</a> |
419 |
name of the pseudo$B!>(Bclass to <var>result</var>.</li> |
name (in <a href="#lower-case">lower$B!>(Bcase</a>) of the pseudo$B!>(Bclass to |
420 |
|
<var>r</var>.</li> |
421 |
<li>Append any arguments as following: |
<li>Append any arguments as following: |
422 |
<dl class=switch> |
<dl class=switch> |
423 |
<dt>If the name of the pseudo$B!>(Bclass is <code>lang</code></dt> |
<dt>If the name of the pseudo$B!>(Bclass is <code>lang</code></dt> |
425 |
<ol> |
<ol> |
426 |
<li>Append a <code class=char>U+0028</code> <code class=charname>LEFT |
<li>Append a <code class=char>U+0028</code> <code class=charname>LEFT |
427 |
PARENTHESIS</code> (<code class=char>(</code>) character |
PARENTHESIS</code> (<code class=char>(</code>) character |
428 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
429 |
<li>Append the |
<li>Append the |
430 |
<a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a> |
<a href="#algorithm-normalize-an-ident" title="normalize a string (IDENT) as an IDENT">normalized</a> |
431 |
language tag (the argument) to <var>result</var>.</li> |
language tag (the argument) to <var>r</var>. |
432 |
|
<span class="issue ed">Should we normalize cases?</span></li> |
433 |
<li>Append a <code class=char>U+0029</code> |
<li>Append a <code class=char>U+0029</code> |
434 |
<code class=charname>RIGHT PARENTHESIS</code> |
<code class=charname>RIGHT PARENTHESIS</code> |
435 |
(<code class=char>)</code>) character |
(<code class=char>)</code>) character |
436 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
437 |
</ol> |
</ol> |
438 |
</dd> |
</dd> |
439 |
<dt>If the name of the pseudo$B!>(Bclass is |
<dt>If the name of the pseudo$B!>(Bclass is |
442 |
<ol> |
<ol> |
443 |
<li>Append a <code class=char>U+0028</code> <code class=charname>LEFT |
<li>Append a <code class=char>U+0028</code> <code class=charname>LEFT |
444 |
PARENTHESIS</code> (<code class=char>(</code>) character |
PARENTHESIS</code> (<code class=char>(</code>) character |
445 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
446 |
<li>Append the |
<li>Append the |
447 |
<a href="#algorithm-normalize-a-string" title="normalize a string">normalized</a> |
<a href="#algorithm-normalize-a-string" title="normalize a string">normalized</a> |
448 |
string (the argument) to <var>result</var>.</li> |
string (the argument) to <var>r</var>.</li> |
449 |
<li>Append a <code class=char>U+0029</code> |
<li>Append a <code class=char>U+0029</code> |
450 |
<code class=charname>RIGHT PARENTHESIS</code> |
<code class=charname>RIGHT PARENTHESIS</code> |
451 |
(<code class=char>)</code>) character |
(<code class=char>)</code>) character |
452 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
453 |
</ol> |
</ol> |
454 |
</dd> |
</dd> |
455 |
<dt>If name of the pseudo$B!>(Bclass is either <code>nth-child</code>, |
<dt>If name of the pseudo$B!>(Bclass is either <code>nth-child</code>, |
459 |
<ol> |
<ol> |
460 |
<li>Append a <code class=char>U+0028</code> <code class=charname>LEFT |
<li>Append a <code class=char>U+0028</code> <code class=charname>LEFT |
461 |
PARENTHESIS</code> (<code class=char>(</code>) character |
PARENTHESIS</code> (<code class=char>(</code>) character |
462 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
463 |
<li>Append <span class=ed>@@ normalized</span> |
<li>Append <span class=ed>@@ normalized</span> |
464 |
integer <var>a</var> to <var>result</var>. |
integer <var>a</var> to <var>r</var>. |
465 |
If the argument is a keyword <code>odd</code> or <code>even</code>, |
If the argument is a keyword <code>odd</code> or <code>even</code>, |
466 |
<var>a</var> is <code>2</code>. If <var>a</var> and |
<var>a</var> is <code>2</code>. If <var>a</var> and |
467 |
<code>n</code> is omitted, <var>a</var> is assumed as |
<code>n</code> is omitted, <var>a</var> is assumed as |
472 |
character).</li> |
character).</li> |
473 |
<li>Append a <code class=char>U+006E</code> |
<li>Append a <code class=char>U+006E</code> |
474 |
<code class=charname>LATIN SMALL LETTER N</code> |
<code class=charname>LATIN SMALL LETTER N</code> |
475 |
(<code class=char>n</code>) character to <var>result</var>.</li> |
(<code class=char>n</code>) character to <var>r</var>.</li> |
476 |
<li>Append <span class=ed>@@ normalized</span> |
<li>Append <span class=ed>@@ normalized</span> |
477 |
integer <var>b</var> to <var>result</var>. |
integer <var>b</var> to <var>r</var>. |
478 |
It <em class=rfc2119>MUST</em> be preceded by a sign, |
It <em class=rfc2119>MUST</em> be preceded by a sign, |
479 |
either <code class=char>U+002B</code> <code class=charname>PLUS |
either <code class=char>U+002B</code> <code class=charname>PLUS |
480 |
SIGN</code> (<code class=char>+</code>) or |
SIGN</code> (<code class=char>+</code>) or |
491 |
<li>Append a <code class=char>U+0029</code> |
<li>Append a <code class=char>U+0029</code> |
492 |
<code class=charname>RIGHT PARENTHESIS</code> |
<code class=charname>RIGHT PARENTHESIS</code> |
493 |
(<code class=char>)</code>) character |
(<code class=char>)</code>) character |
494 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
495 |
</ol> |
</ol> |
496 |
</dd> |
</dd> |
497 |
<dt>If the name of the pseudo$B!>(Bclass is <code>not</code></dt> |
<dt>If the name of the pseudo$B!>(Bclass is <code>not</code></dt> |
505 |
<code class=charname>LATIN SMALL LETTER T</code>, and |
<code class=charname>LATIN SMALL LETTER T</code>, and |
506 |
<code class=char>U+0028</code> <code class=charname>LEFT |
<code class=char>U+0028</code> <code class=charname>LEFT |
507 |
PARENTHESIS</code> (<code>:not(</code>), followed by a |
PARENTHESIS</code> (<code>:not(</code>), followed by a |
508 |
<a href="#newline">newline</a>, to <var>result</var>.</li> |
<a href="#newline">newline</a>, to <var>r</var>.</li> |
509 |
<li>Append four <code class=char>U+0020</code> |
<li>Append four <code class=char>U+0020</code> |
510 |
<code class=charname>SPACE</code> characters to |
<code class=charname>SPACE</code> characters to |
511 |
<var>result</var>.</li> |
<var>r</var>.</li> |
512 |
<li>Append four <code class=char>U+0020</code> |
<li>Append four <code class=char>U+0020</code> |
513 |
<code class=charname>SPACE</code> characters to |
<code class=charname>SPACE</code> characters to |
514 |
<var>result</var> again.</li> |
<var>r</var> again.</li> |
515 |
<li><a href="#algorithm-serialize-a-simple-selector">Serialize |
<li><a href="#algorithm-serialize-a-simple-selector">Serialize |
516 |
the simple selector specified as the argument to the |
the simple selector specified as the argument to the |
517 |
<code>not</code> pseudo$B!>(Bclass</a>.</li> |
<code>not</code> pseudo$B!>(Bclass</a>.</li> |
518 |
<li>Append a <a href="#newline">newline</a> to |
<li>Append a <a href="#newline">newline</a> to |
519 |
<var>result</var>.</li> |
<var>r</var>.</li> |
520 |
<li>Append four <code class=char>U+0020</code> |
<li>Append four <code class=char>U+0020</code> |
521 |
<code class=charname>SPACE</code> characters to |
<code class=charname>SPACE</code> characters to |
522 |
<var>result</var>.</li> |
<var>r</var>.</li> |
523 |
<li>Append a <code class=char>U+0029</code> |
<li>Append a <code class=char>U+0029</code> |
524 |
<code class=charname>RIGHT PARENTHESIS</code> |
<code class=charname>RIGHT PARENTHESIS</code> |
525 |
(<code class=char>)</code>) character |
(<code class=char>)</code>) character |
526 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
527 |
</ol> |
</ol> |
528 |
</dd> |
</dd> |
529 |
|
<dt>Otherwise</dt> |
530 |
|
<dd>The pseudo$B!>(Bclass is not supported by this version of |
531 |
|
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
532 |
|
and therefore no |
533 |
|
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
534 |
|
representation is defined for <var>ss</var>. Stop the algorithm.</dd> |
535 |
</dl> |
</dl> |
536 |
</li> |
</li> |
537 |
</ol> |
</ol> |
541 |
<ol> |
<ol> |
542 |
<li>Append two <code class=char>U+003A</code> |
<li>Append two <code class=char>U+003A</code> |
543 |
<code class=charname>COLON</code> characters (<code>::</code>) |
<code class=charname>COLON</code> characters (<code>::</code>) |
544 |
to <var>result</var>.</li> |
to <var>r</var>.</li> |
545 |
<li>Append the |
<li>Append the |
546 |
<a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a> |
<a href="#algorithm-normalize-an-ident" title="normalize a string (IDENT) as an IDENT">normalized</a> |
547 |
name of the pseudo$B!>(Belement to <var>result</var>.</li> |
name (in <a href="#lower-case">lower$B!>(Bcase</a>) of the pseudo$B!>(Belement |
548 |
<!-- For future version: append "(", arguments, ")", if any. --> |
to <var>r</var>.</li> |
549 |
|
<li>If the pseudo$B!>(Belement has any arguments: |
550 |
|
The pseudo$B!>(Belement is not supported by this version of |
551 |
|
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
552 |
|
and therefore no |
553 |
|
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
554 |
|
representation is defined for <var>ss</var>. Stop the algorithm. |
555 |
|
</li> |
556 |
</ol> |
</ol> |
557 |
</dd> |
</dd> |
558 |
</dl> |
</dl> |
559 |
|
</li> |
560 |
|
<li>Then, <var>r</var> is the |
561 |
|
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
562 |
|
representation of <var>ss</var>.</li> |
563 |
|
</ol> |
564 |
|
|
565 |
</div> |
</div> |
566 |
|
|
568 |
<h3>Serializing Groups of Selectors</h3> |
<h3>Serializing Groups of Selectors</h3> |
569 |
|
|
570 |
<p>No <abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
<p>No <abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
571 |
representation is defined for an invalid group of selectors.</p> |
representation is defined for an invalid |
572 |
|
<a href="http://www.w3.org/TR/css3-selectors/#grouping">group of |
573 |
<div class="note memo"> |
selectors</a>.</p> |
|
<p>The serialized representation will not contain any comment.</p> |
|
|
</div> |
|
|
|
|
|
<!-- TODO: link terms to Selectors --> |
|
574 |
|
|
575 |
<p>To |
<p>To |
576 |
<dfn id=algorithm-serialize-a-group-of-selectors title="serialize a group of selectors">serialize |
<dfn id=algorithm-serialize-a-group-of-selectors title="serialize a group of selectors">serialize |
577 |
a group of selectors (<dfn id=var-gs><var>gs</var></dfn>)</dfn>:</p> |
a group of selectors (<dfn id=var-gs><var>gs</var></dfn>)</dfn>, |
578 |
|
the following algorithm <em class=rfc2119>MUST</em> be used:</p> |
579 |
<ol> |
<ol> |
580 |
<li>Let <dfn id=var-result><var>result</var></dfn> an empty string.</li> |
<li>Let <dfn id=var-result><var>result</var></dfn> an empty string.</li> |
581 |
<li>For each selector (<dfn id=var-selector><var>selector</var></dfn>) in |
<li>For each selector (<dfn id=var-selector><var>selector</var></dfn>) in |
582 |
<var>gs</var>: |
<var>gs</var>: |
583 |
<ol> |
<ol> |
584 |
<li>If <var>selector</var> is <em>not</em> the first selector |
<li>If <var>selector</var> is <em>not</em> the first selector |
585 |
in the group of selectors, then append a <code class=char>U+002C</code> |
in the <var>gs</var>, then append a <code class=char>U+002C</code> |
586 |
<code class=charname>COMMA</code> (<code class=char>,</code>) followed by a |
<code class=charname>COMMA</code> (<code class=char>,</code>) followed by a |
587 |
<a href="#newline">newline</a> to <var>result</var>.</li> |
<a href="#newline">newline</a> to <var>result</var>.</li> |
588 |
<li>Append four <code class=char>U+0020</code> |
<li>Append four <code class=char>U+0020</code> |
589 |
<code class=charname>SPACE</code> characters to <var>result</var>.</li> |
<code class=charname>SPACE</code> characters to <var>result</var>.</li> |
590 |
<li>Process each sequence of simple selectors or |
<li>Process each sequence of simple selectors or |
591 |
combinator in <var>selector</var> by following algorithm: |
combinator in <var>selector</var> as following: |
592 |
<dl class=switch> |
<dl class=switch> |
593 |
<dt>If it is a sequence of simle selector |
<dt>If it is a sequence of simle selector |
594 |
(<dfn id=var-sss><var>sss</var></dfn>)</dt> |
(<dfn id=var-sss><var>sss</var></dfn>)</dt> |
605 |
<ol> |
<ol> |
606 |
<li>Append two <code class=char>U+0020</code> |
<li>Append two <code class=char>U+0020</code> |
607 |
<code class=charname>SPACE</code> characters to <var>result</var>.</li> |
<code class=charname>SPACE</code> characters to <var>result</var>.</li> |
608 |
<li> |
<li>Process <var>c</var> as following: |
609 |
|
|
610 |
<dl class=switch> |
<dl class=switch> |
611 |
<dt>If <var>c</var> is descendant combinator (white space)</dt> |
<dt>If <var>c</var> is descendant combinator (white space)</dt> |
612 |
<dd>Append a <code class=char>U+0020</code> |
<dd>Append a <code class=char>U+0020</code> |
649 |
<div class="section" id="parsing"> |
<div class="section" id="parsing"> |
650 |
<h2>Parsing |
<h2>Parsing |
651 |
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
652 |
Groups of Selectors</h2> |
Representations of Selectors</h2> |
653 |
|
|
654 |
<p>Since <a href="#serializing">the serializing algorithm</a> is |
<p>Since <a href="#algorithm-serialize-a-group-of-selectors">the serializing |
655 |
so designed that it always output a valid |
algorithm for groups of selectors</a> is so designed that it always outputs a |
656 |
<a href="http://www.w3.org/TR/css3-selectors/#grouping">group of |
valid <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of |
657 |
selectors</a>, no special parser for the |
selectors</a>, no special parser for the |
658 |
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
659 |
representation is necessary. Any conforming parser for |
representation is necessary. Any conforming parser for |
660 |
<a href="http://www.w3.org/TR/css3-selectors/#grouping">groups of |
<a href="http://www.w3.org/TR/css3-selectors/#grouping">groups of |
661 |
selectors</a> <em class=rfc2119>MAY</em> be used |
selectors</a> <em class=rfc2119>MAY</em> be used |
662 |
to parse <abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
to parse <abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
663 |
representations of groups of selectors.</p> |
representations of |
664 |
|
<a href="http://www.w3.org/TR/css3-selectors/#grouping">groups of |
665 |
|
selectors</a>.</p> |
666 |
|
|
667 |
|
<p>Likewise, <a href="#algorithm-serialize-a-simple-selector">the serializing |
668 |
|
algorithm for simple selectors</a> always outputs a valid |
669 |
|
<a href="#simple-selector">simple selector</a> and therefore any |
670 |
|
conforming parser for <a href="#simple-selector">simple selector</a> |
671 |
|
<em class=rfc2119>MAY</em> be used to parse |
672 |
|
<abbr title="Selectors Serialization Format for Testing">SSFT</abbr> |
673 |
|
representations of <a href="#simple-selector">simple selectors</a>.</p> |
674 |
</div> |
</div> |
675 |
|
|
676 |
<div class="section" id="examples"> |
<div class="section" id="examples"> |
706 |
<a href="urn:ietf:bcp:14"><abbr title="Best Current Practice">BCP</abbr> |
<a href="urn:ietf:bcp:14"><abbr title="Best Current Practice">BCP</abbr> |
707 |
14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, |
14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, |
708 |
<time datetime=1997-03>March 1997</time>. |
<time datetime=1997-03>March 1997</time>. |
709 |
This version of the specification is referenced</dd> |
This version of the specification is referenced.</dd> |
710 |
<dt id=ref-SELECTORS>SELECTORS</dt> |
<dt id=ref-SELECTORS>SELECTORS</dt> |
711 |
<dd><a href="http://www.w3.org/TR/2005/WD-css3-selectors-20051215"><cite>Selectors</cite></a>, |
<dd><a href="http://www.w3.org/TR/2005/WD-css3-selectors-20051215"><cite>Selectors</cite></a>, |
712 |
<abbr title="World Wide Web Consortium">W3C</abbr> Working Draft, |
<abbr title="World Wide Web Consortium">W3C</abbr> Working Draft, |