| 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> |