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-28>28 October 2007</time></h2> |
<h2>Working Draft <time datetime=2007-11-05>5 November 2007</time></h2> |
14 |
|
|
15 |
<dl class="versions-uri"> |
<dl class="versions-uri"> |
16 |
<dt>This Version</dt> |
<dt>This Version</dt> |
162 |
selector</a> or <a href="#algorithm-serialize-a-group-of-selectors">serialize |
selector</a> or <a href="#algorithm-serialize-a-group-of-selectors">serialize |
163 |
a group of selectors</a>.</p> |
a group of selectors</a>.</p> |
164 |
|
|
|
<div class="issue ed"> |
|
|
<p><a href="http://suika.fam.cx/gate/cvs/*checkout*/markup/html/whatpm/Whatpm/CSS/SelectorsSerializer.pm">See |
|
|
also the reference implementation</a> for now.</p> |
|
|
</div> |
|
|
|
|
165 |
<div class="note memo"> |
<div class="note memo"> |
166 |
<p>The serialized representation will not contain any comment.</p> |
<p>The serialized representation will not contain any comment.</p> |
167 |
</div> |
</div> |
168 |
<!-- TODO: link terms to Selectors --> |
|
169 |
|
<div class="ed issue"><p>TODO: link terms to Selectors</p></div> |
170 |
|
|
171 |
<div class=section id=serializing-tokens> |
<div class=section id=serializing-tokens> |
172 |
<h3>Serializing Tokens</h3> |
<h3>Serializing Tokens</h3> |
292 |
It is tr/A-Z/a-z/ for now.</p> |
It is tr/A-Z/a-z/ for now.</p> |
293 |
</div> |
</div> |
294 |
|
|
295 |
|
<p>To |
296 |
|
<dfn id=algorithm-normalize-an-integer title="normalize an integer">normalize |
297 |
|
an integer (<dfn id=var-int-i><var>i</var></dfn>)</dfn>, the following |
298 |
|
algorithm <em class=rfc2119>MUST</em> be run:</p> |
299 |
|
<ol class=algorithm> |
300 |
|
<li>If <var>i</var> is equal to zero (0), return a string with only a |
301 |
|
character: <code class=char>U+0030</code> |
302 |
|
<code class=charname>DIGIT ZERO</code> (<code class=char>0</code>). |
303 |
|
Stop the algorithm.</li> |
304 |
|
<li>Let <dfn id=var-int-result><var>result</var></dfn> be an empty string.</li> |
305 |
|
<li>If <var>i</var> is less than zero (0), append a |
306 |
|
<code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code> |
307 |
|
(<code class=char>-</code>) character to <var>result</var>.</li> |
308 |
|
<li>Append the decimal representation of the absolute value of |
309 |
|
<var>i</var> to <var>result</var>. The decimal (base$B!>(Bten) representation |
310 |
|
<em class=rfc2119>MUST NOT</em> begin with a <code class=char>U+0030</code> |
311 |
|
<code class=charname>DIGIT ZERO</code> (<code class=char>0</code>) |
312 |
|
character.</li> |
313 |
|
<li>Return <var>result</var>.</li> |
314 |
|
</ol> |
315 |
|
|
316 |
</div> |
</div> |
317 |
|
|
318 |
|
|
477 |
<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 |
478 |
PARENTHESIS</code> (<code class=char>(</code>) character |
PARENTHESIS</code> (<code class=char>(</code>) character |
479 |
to <var>r</var>.</li> |
to <var>r</var>.</li> |
480 |
<li>Append <span class=ed>@@ normalized</span> |
<li>Let <dfn id=var-a><var>a</var></dfn> be the <var>a</var> |
481 |
integer <var>a</var> to <var>r</var>. |
part of the argument. If the argument is a keyword <code>odd</code> |
482 |
If the argument is a keyword <code>odd</code> or <code>even</code>, |
or <code>even</code>, then let <var>a</var> be <code>2</code>. |
483 |
<var>a</var> is <code>2</code>. If <var>a</var> and |
If the <var>a</var> part with following <code>n</code> character |
484 |
<code>n</code> is omitted, <var>a</var> is assumed as |
is omitted, then let <var>a</var> be <code>0</code>. |
485 |
<code>0</code>. Otherwise, if <var>a</var> is omitted, |
Otherwise, if only the <var>a</var> part is omitted, then |
486 |
it is assumed as <code>1</code> (or <code>-1</code>, |
let <var>a</var> be <code>1</code>. Otherwise, if the <var>a</var> |
487 |
if there is a <code class=char>U+002D</code> |
part is <code>-</code>, then let <var>a</var> be |
488 |
<code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>) |
<code>-1</code>.</li> |
489 |
character).</li> |
<li>Let <var>a</var> be the |
490 |
|
<a href="#algorithm-normalize-an-integer" title="normalize an integer">normalized |
491 |
|
string representation</a> of integer <var>a</var>.</li> |
492 |
|
<li>Append <var>a</var> to <var>result</var>.</li> |
493 |
<li>Append a <code class=char>U+006E</code> |
<li>Append a <code class=char>U+006E</code> |
494 |
<code class=charname>LATIN SMALL LETTER N</code> |
<code class=charname>LATIN SMALL LETTER N</code> |
495 |
(<code class=char>n</code>) character to <var>r</var>.</li> |
(<code class=char>n</code>) character to <var>r</var>.</li> |
496 |
<li>Append <span class=ed>@@ normalized</span> |
<li>Let <dfn id=var-b><var>b</var></dfn> be the <var>b</var> |
497 |
integer <var>b</var> to <var>r</var>. |
part of the argument. If the argument is a keyword <code>odd</code>, |
498 |
It <em class=rfc2119>MUST</em> be preceded by a sign, |
then let <var>b</var> be <code>1</code>. If the argument is a |
499 |
either <code class=char>U+002B</code> <code class=charname>PLUS |
keyword <code>even</code>, then let <var>b</var> be <code>0</code>. |
500 |
SIGN</code> (<code class=char>+</code>) or |
If the <var>b</var> part is omitted, then let <var>b</var> be |
501 |
<code class=char>U+002D</code> |
<code>0</code>.</li> |
502 |
|
<li>Let <var>b</var> be the |
503 |
|
<a href="#algorithm-normalize-an-integer" title="normalize an integer">normalized |
504 |
|
string representation</a> of integer <var>b</var>.</li> |
505 |
|
<li>If <var>b</var> does <em>not</em> start with a |
506 |
|
<code class=char>U+002D</code> |
507 |
<code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>) |
<code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>) |
508 |
character. If the argument is a keyword <code>odd</code>, |
character, then append <code class=char>U+002B</code> |
509 |
<var>b</var> is <code>1</code>. If the argument |
<code class=charname>PLUS SIGN</code> |
510 |
is a keyword <code>even</code>, <var>b</var> is |
(<code class=char>+</code>) to <var>result</var>.</li> |
511 |
<code>0</code>. If <var>b</var> is omitted, it is assumed as |
<li>Append <var>b</var> to <var>result</var>.</li> |
|
<code>0</code>. The sign of <code>0</code> |
|
|
<em class=rfc2119>MUST</em> be <code class=char>U+002B</code> |
|
|
<code class=charname>PLUS SIGN</code> |
|
|
(<code class=char>+</code>).</li> |
|
512 |
<li>Append a <code class=char>U+0029</code> |
<li>Append a <code class=char>U+0029</code> |
513 |
<code class=charname>RIGHT PARENTHESIS</code> |
<code class=charname>RIGHT PARENTHESIS</code> |
514 |
(<code class=char>)</code>) character |
(<code class=char>)</code>) character |
615 |
(<dfn id=var-sss><var>sss</var></dfn>)</dt> |
(<dfn id=var-sss><var>sss</var></dfn>)</dt> |
616 |
<dd> |
<dd> |
617 |
<ol> |
<ol> |
618 |
<li class=ed><a href="#algorithm-serialize-a-simple-selector">Serialize |
<li>If <var>sss</var> contains a universal or type selector, then |
619 |
each simple selector</a> in <var>sss</var>.</li> |
<a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">serialize |
620 |
<li class=ed>sort</li> |
that simple selector</a> and append the result to |
621 |
|
<var>result</var>.</li> |
622 |
|
<li>Otherwise, i.e. if <var>sss</var> does not contain a universal or |
623 |
|
type selector, then |
624 |
|
<a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">serialize |
625 |
|
a simple selector <code>*</code></a> and append the result to |
626 |
|
<var>result</var>.</li> |
627 |
|
<li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize |
628 |
|
any attribute selectors</a> in <var>sss</var>, sort the results, |
629 |
|
then append them to <var>result</var> in order.</li> |
630 |
|
<li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize |
631 |
|
any class selectors</a> in <var>sss</var>, sort the results, |
632 |
|
then append them to <var>result</var> in order.</li> |
633 |
|
<li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize |
634 |
|
any <abbr>ID</abbr> selectors</a> in <var>sss</var>, sort the results, |
635 |
|
then append them to <var>result</var> in order.</li> |
636 |
|
<li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize |
637 |
|
any pseudo$B!>(Bclass selectors</a> in <var>sss</var>, sort the results, |
638 |
|
then append them to <var>result</var> in order.</li> |
639 |
|
<li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize |
640 |
|
any pseudo elements</a> in <var>sss</var>, sort the results, |
641 |
|
then append them to <var>result</var> in order.</li> |
642 |
<li>Append a <a href="#newline">newline</a> to <var>result</var>.</li> |
<li>Append a <a href="#newline">newline</a> to <var>result</var>.</li> |
643 |
</ol> |
</ol> |
644 |
</dd> |
</dd> |