/[suikacvs]/markup/selectors/ssft/ssft-work.en.html
Suika

Diff of /markup/selectors/ssft/ssft-work.en.html

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.6 by wakaba, Tue Oct 2 10:13:58 2007 UTC revision 1.11 by wakaba, Mon Oct 22 10:30:53 2007 UTC
# Line 10  Line 10 
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-02>2 October 2007</time></h2>  <h2>Working Draft <time datetime=2007-10-22>22 October 2007</time></h2>
14    
15  <dl class="versions-uri">  <dl class="versions-uri">
16  <dt>This Version</dt>  <dt>This Version</dt>
# Line 63  available at <code class="URI">&lt;<a Line 63  available at <code class="URI">&lt;<a
63  at the time of its publication.  Other documents  at the time of its publication.  Other documents
64  might supersede this document.</em></p>  might supersede this document.</em></p>
65    
66  <p>This document is a working draft, produced as part  <p>This document is a working draft, produced as part of the
67    <a href="http://suika.fam.cx/www/markup/html/whatpm/readme">Whatpm</a>
68    subproject
69  of the <a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a>  of the <a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a>
70  project.  It might be updated, replaced, or obsoleted by  project.  It might be updated, replaced, or obsoleted by
71  other documents at any time.  It is inappropriate to  other documents at any time.  It is inappropriate to
# Line 80  normative version.</p> Line 82  normative version.</p>
82  <div id="introduction" class="section">  <div id="introduction" class="section">
83  <h2>Introduction</h2>  <h2>Introduction</h2>
84    
85  <p class=section-info>This section is <em>non-normative</em>.</p>  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>
86    
87  <p>Selectors  <p>Selectors
88  <cite class="bibref normative">[<a href="#ref-SELECTORS">SELECTORS</a>]</cite>  <cite class="bibref normative">[<a href="#ref-SELECTORS">SELECTORS</a>]</cite>
# Line 116  in not escaping unsafe identifiers.</p> Line 118  in not escaping unsafe identifiers.</p>
118  <div class="section" id="terminology">  <div class="section" id="terminology">
119  <h2>Terminology</h2>  <h2>Terminology</h2>
120    
121  <p>The key words <q><em class="rfc2119">MUST</em></q>,  <p>The key words <q><dfn id=must><em class="rfc2119">MUST</em></dfn></q>,
122  <q><em class="rfc2119">MUST NOT</em></q>,  <q><dfn id=must-not><em class="rfc2119">MUST NOT</em></dfn></q>,
123  <q><em class="rfc2119">SHOULD</em></q>,  <q><dfn id=should><em class="rfc2119">SHOULD</em></dfn></q>,
124  <q><em class="rfc2119">SHOULD NOT</em></q>, and  <q><dfn id=should-not><em class="rfc2119">SHOULD NOT</em></dfn></q>, and
125  <q><em class=rfc2119>MAY</em></q> in this  <q><dfn id=may><em class=rfc2119>MAY</em></dfn></q> in this
126  document are to be interpreted as described in  document are to be interpreted as described in
127  <a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>  <a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>
128  2119</a>  2119</a>
129  <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>  <cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
130    
131  <!-- Strictly speaking the paragraph below is not part of terminology. -->  <!-- Strictly speaking the paragraph below is not part of terminology. -->
132  <p>All examples and notes in this specification are non-normative,  <p>All examples and notes in this specification are non$B!>(Bnormative,
133  as are all sections explicitly marked non-normative.  Everything  as are all sections explicitly marked non$B!>(Bnormative.  Everything
134  else in this specification is normative.</p>  else in this specification is normative.</p>
135    
136    <p>For the purpose of this specification, pseudo$B!>(Belements are also
137    referred to as <dfn title="simple selector" id=simple-selector>simple
138    selectors</dfn> and are considered as part of the last sequence of
139    simple selector in a selector.</p>
140  </div>  </div>
141    
142  <div class="section" id="serializing">  <div class="section" id="serializing">
# Line 140  else in this specification is normative. Line 147  else in this specification is normative.
147  for now.</p>  for now.</p>
148  </div>  </div>
149    
150  <p><dfn id=newline>Newline</dfn> is <code class=char>U+000A</code>  <p>No <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
151  <code class=charname>LINE FEED</code> <span class=ed>or  representation is defined for an invalid group of selectors.</p>
152  U+000D U+000A or U+000A ??</span>.</p>  
153    <div class="note memo">
154    <p>The serialized representation will not contain any comment.</p>
155    </div>
156    
157  <!-- TODO: link terms to Selectors -->  <!-- TODO: link terms to Selectors -->
158    
159  <p>To <dfn id=algorithm-serialize-a-group-of-selectors>serialize a group of  <p>To
160  selectors</dfn> (<dfn id=var-gs><var>gs</var></dfn>):</p>  <dfn id=algorithm-serialize-a-group-of-selectors title="serialize a group of selectors">serialize
161    a group of selectors (<dfn id=var-gs><var>gs</var></dfn>)</dfn>:</p>
162  <ol>  <ol>
163  <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>
164  <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
# Line 155  selectors</dfn> (<dfn id=var-gs><var>gs< Line 166  selectors</dfn> (<dfn id=var-gs><var>gs<
166    <ol>    <ol>
167    <li>If <var>selector</var> is <em>not</em> the first selector    <li>If <var>selector</var> is <em>not</em> the first selector
168    in the group of selectors, then append a <code class=char>U+002C</code>    in the group of selectors, then append a <code class=char>U+002C</code>
169    <code class=charname>COMMA</code> followed by a    <code class=charname>COMMA</code> (<code class=char>,</code>) followed by a
170    <a href="#newline">newline</a> to <var>result</var>.</li>    <a href="#newline">newline</a> to <var>result</var>.</li>
171    <li>Append four <code class=char>U+0020</code>    <li>Append four <code class=char>U+0020</code>
172    <code class=charname>SPACE</code> characters to <var>result</var>.</li>    <code class=charname>SPACE</code> characters to <var>result</var>.</li>
# Line 164  selectors</dfn> (<dfn id=var-gs><var>gs< Line 175  selectors</dfn> (<dfn id=var-gs><var>gs<
175      <dl class=switch>      <dl class=switch>
176      <dt>If it is a sequence of simle selector      <dt>If it is a sequence of simle selector
177      (<dfn id=var-sss><var>sss</var></dfn>)</dt>      (<dfn id=var-sss><var>sss</var></dfn>)</dt>
178        <dd class=ed>@@</dd>        <dd>
179            <ol>
180            <li class=ed><a href="#algorithm-serialize-a-simple-selector">Serialize
181            each simple selector</a> in <var>sss</var>.</li>
182            <li class=ed>sort</li>
183            <li>Append a <a href="#newline">newline</a> to <var>result</var>.</li>
184            </ol>
185          </dd>
186      <dt>If it is a combinator (<dfn id=var-c><var>c</var></dfn>)</dt>      <dt>If it is a combinator (<dfn id=var-c><var>c</var></dfn>)</dt>
187        <dd>        <dd>
188          <ol>          <ol>
# Line 179  selectors</dfn> (<dfn id=var-gs><var>gs< Line 197  selectors</dfn> (<dfn id=var-gs><var>gs<
197            <dt>If <var>c</var> is child combinator            <dt>If <var>c</var> is child combinator
198            (<code class=char>></code>)</dt>            (<code class=char>></code>)</dt>
199              <dd>Append a <code class=char>U+003E</code>              <dd>Append a <code class=char>U+003E</code>
200              <code class=charname>GREATER-THAN SIGN</code> character to              <code class=charname>GREATER-THAN SIGN</code>
201              <var>result</var>.</dd>              (<code class=char>></code>) character to <var>result</var>.</dd>
202            <dt>If <var>c</var> is adjacent sibling combinator            <dt>If <var>c</var> is adjacent sibling combinator
203            (<code class=char>+</code>)</dt>            (<code class=char>+</code>)</dt>
204              <dd>Append a <code class=char>U+002B</code>              <dd>Append a <code class=char>U+002B</code>
205              <code class=charname>PLUS SIGN</code> character to              <code class=charname>PLUS SIGN</code> (<code class=char>+</code>)
206              <var>result</var>.</dd>              character to <var>result</var>.</dd>
207            <dt>If <var>c</var> is general sibling combinator            <dt>If <var>c</var> is general sibling combinator
208            (<code class=char>~</code>)</dt>            (<code class=char>~</code>)</dt>
209              <dd>Append a <code class=char>U+007E</code>              <dd>Append a <code class=char>U+007E</code>
210              <code class=charname>TILDE</code> character to              <code class=charname>TILDE</code> (<code class=char>~</code>)
211              <var>result</var>.</dd>              character to <var>result</var>.</dd>
212            </dl>            </dl>
213          </li>          </li>
214          <li>Append a <code class=char>U+0020</code>          <li>Append a <code class=char>U+0020</code>
# Line 202  selectors</dfn> (<dfn id=var-gs><var>gs< Line 220  selectors</dfn> (<dfn id=var-gs><var>gs<
220    </ol>    </ol>
221  </li>  </li>
222  <li>Then, <var>result</var> is the  <li>Then, <var>result</var> is the
223  <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>  <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
224  representation of the group of selectors.</li>  representation of <var>gs</var>.</li>
225  </ol>  </ol>
226    
227  <p>To <dfn id=algorithm-serialize-a-simple-selector>serialize a simple  <p>To
228  selector</dfn> (<dfn><var id=var-ss>ss</var></dfn>):</p>  <dfn id=algorithm-serialize-a-simple-selector title="serialize a simple selector">serialize
229    a simple selector (<dfn><var id=var-ss>ss</var></dfn>)</dfn>:</p>
230  <dl class=switch>  <dl class=switch>
231  <dt>If <var>ss</var> is a type or universal selector</dt>  <dt>If <var>ss</var> is a type or universal selector</dt>
232    <dd><dl class=switch>    <dd>
233    <dt>If a namespace URI is specified (via namespace prefix, or      <ol>
234    by omitting namespace prefix where a default namespace is specified)</dt>      <li>
235      <dd class="ed">@@</dd>        <dl class=switch>
236    <dt>If the null namespace is specified (by zero$B!>(Blength namespace        <dt>If a namespace URI is specified (via namespace prefix, or
237    prefix)</dt>        by omitting namespace prefix where a default namespace is specified)</dt>
238      <dd>Return a <code class=char>U+007C</code> <code class=charname>VERTICAL          <dd class="ed">@@</dd>
239      BAR</code> character, followed by either local name (if <var>ss</var>        <dt>If the null namespace is specified (by zero$B!>(Blength namespace
240      is a type selector) or a <code class=char>U+002A</code>        prefix)</dt>
241      <code class=charname>ASTERISK</code> character (if <var>ss</var>          <dd>Append a <code class=char>U+007C</code>
242      is a universal selector).</dd>          <code class=charname>VERTICAL BAR</code> (<code class=char>|</code>)
243    <dt>If no namespace is specified (by namespace prefix <code>*</code>,          character to <var>result</var>.</dd>
244    or by omitting namespace prefix where no default namespace is specified)</dt>        <dt>If no namespace is specified (by namespace prefix <code>*</code>,
245      <dd>Return a <code class=char>U+002A</code>        or by omitting namespace prefix where no default namespace is
246      <code class=charname>ASTERISK</code> character, followed by a        specified)</dt>
247      <code class=char>U+007C</code> <code class=charname>VERTICAL BAR</code>          <dd>Append a <code class=char>U+002A</code>
248      character, followed by either local name (if <var>ss</var>          <code class=charname>ASTERISK</code> (<code class=char>*</code>)
249      is a type selector) or a <code class=char>U+002A</code>          character, followed by a <code class=char>U+007C</code>
250      <code class=charname>ASTERISK</code> character (if <var>ss</var>          <code class=charname>VERTICAL BAR</code> (<code class=char>|</code>)
251      is a universal selector).</dd>          character, to <var>result</var>.</dd>
252    </dl></dd>        </dl>
253  <dt class=ed>@@</dt>      </li>
254        <li>If <var>ss</var> is a type selector, append the
255        <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
256        local name to <var>result</var>.</li>
257        <li>If <var>ss</var> is a universal selector, append
258        a <code class=char>U+002A</code> <code class=charname>ASTERISK</code>
259        (<code class=char>*</code>) character to <var>result</var>.</li>
260        </ol>
261      </dd>
262    <dt>If <var>ss</var> is an attribute selector</dt>
263      <dd>
264        <ol>
265        <li>Append a <code class=char>U+005B</code> <code class=charname>LEFT
266        SQUARE BRACKET</code> (<code class=char>[</code>) to
267        <var>result</var>.</li>
268        <li>
269          Append a namespace prefix as following:
270          <dl>
271          <dt>If a namespace URI is specified</dt>
272            <dd class=ed>@@</dd>
273            <dd class=ed>@@ Current reference implementation is wrong,
274            since its result of sorting depends on namespace prefix.</dd>
275          <dt>If the null namespace is specified</dt>
276            <dd>Append a <code class=char>U+007C</code>
277            <code class=charname>VERTICAL BAR</code> character to
278            <var>result</var>.</dd>
279          <dt>If no namespace is specified</dt>
280            <dd>Append a <code class=char>U+002A</code>
281            <code class=charname>ASTERISK</code> (<code class=char>*</code>)
282            character, followed by a <code class=char>U+007C</code>
283            <code class=charname>VERTICAL BAR</code> (<code class=char>|</code>)
284            character, to <var>result</var>.</dd>
285          </dl>
286        </li>
287        <li>Append the
288        <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
289        local name to <var>result</var>.</li>
290        <li>If a value is specified in <var>ss</var>:
291          <ol>
292          <li>Depending on the way to match, append <code>=</code>,
293          <code>~=</code>, <code>|=</code>, <code>^=</code>,
294          <code>$=</code>, or <code>*=</code> to <var>result</var>.</li>
295          <li>Append the
296          <a href="#algorithm-normalize-a-string" title="normalize a string">normalized</a>
297          value to <var>result</var>.</li>
298          </ol>
299        </li>
300        <li>Append a <code class=char>U+005D</code> <code class=charname>RIGHT
301        SQUARE BRACKET</code> (<code class=char>]</code>) to
302        <var>result</var>.</li>
303        </ol>
304      </dd>
305    <dt>If <var>ss</var> is a class selector</dt>
306      <dd>Append a <code class=char>U+002E</code> <code class=charname>FULL
307      STOP</code> (<code class=char>.</code>) character, followed
308      by <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
309      class name, <var>result</var>.</dd>
310    <dt>If <var>ss</var> is an <abbr>ID</abbr> selector</dt>
311      <dd>Append a <code class=char>U+0023</code> <code class=charname>NUMBER
312      SIGN</code> (<code class=char>#</code>) character, followed
313      by <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
314      <abbr>ID</abbr>, to <var>result</var>.</dd>
315    <dt>If <var>ss</var> is a pseudo$B!>(Bclass selector</dt>
316      <dd>
317        <ol>
318        <li>Append a <code class=char>U+003A</code>
319        <code class=charname>COLON</code> (<code class=char>:</code>) character
320        to <var>result</var>.</li>
321        <li>Append the
322        <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
323        name of the pseudo$B!>(Bclass to <var>result</var>.</li>
324        <li>Append any arguments as following:
325          <dl class=switch>
326          <dt>If the name of the pseudo$B!>(Bclass is <code>lang</code></dt>
327            <dd>
328              <ol>
329              <li>Append a <code class=char>U+0028</code> <code class=charname>LEFT
330              PARENTHESIS</code> (<code class=char>(</code>) character
331              to <var>result</var>.</li>
332              <li>Append the
333              <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
334              language tag (the argument) to <var>result</var>.</li>
335              <li>Append a <code class=char>U+0029</code>
336              <code class=charname>RIGHT PARENTHESIS</code>
337              (<code class=char>)</code>) character
338              to <var>result</var>.</li>
339              </ol>
340            </dd>
341          <dt>If the name of the pseudo$B!>(Bclass is
342          <code>-manakai-contains</code></dt>
343            <dd>
344              <ol>
345              <li>Append a <code class=char>U+0028</code> <code class=charname>LEFT
346              PARENTHESIS</code> (<code class=char>(</code>) character
347              to <var>result</var>.</li>
348              <li>Append the
349              <a href="#algorithm-normalize-a-string" title="normalize a string">normalized</a>
350              string (the argument) to <var>result</var>.</li>
351              <li>Append a <code class=char>U+0029</code>
352              <code class=charname>RIGHT PARENTHESIS</code>
353              (<code class=char>)</code>) character
354              to <var>result</var>.</li>
355              </ol>
356            </dd>
357          <dt>If name of the pseudo$B!>(Bclass is either <code>nth-child</code>,
358          <code>nth-last-child</code>, <code>nth-of-type</code>, or
359          <code>nth-last-of-type</code></dt>
360            <dd>
361              <ol>
362              <li>Append a <code class=char>U+0028</code> <code class=charname>LEFT
363              PARENTHESIS</code> (<code class=char>(</code>) character
364              to <var>result</var>.</li>
365              <li>Append <span class=ed>@@ normalized</span>
366              integer <var>a</var> to <var>result</var>.
367              If the argument is a keyword <code>odd</code> or <code>even</code>,
368              <var>a</var> is <code>2</code>.  If <var>a</var> and
369              <code>n</code> is omitted, <var>a</var> is assumed as
370              <code>0</code>.  Otherwise, if <var>a</var> is omitted,
371              it is assumed as <code>1</code> (or <code>-1</code>,
372              if there is a <code class=char>U+002D</code>
373              <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>)
374              character).</li>
375              <li>Append a <code class=char>U+006E</code>
376              <code class=charname>LATIN SMALL LETTER N</code>
377              (<code class=char>n</code>) character to <var>result</var>.</li>
378              <li>Append <span class=ed>@@ normalized</span>
379              integer <var>b</var> to <var>result</var>.
380              It <em class=rfc2119>MUST</em> be preceded by a sign,
381              either <code class=char>U+002B</code> <code class=charname>PLUS
382              SIGN</code> (<code class=char>+</code>) or
383              <code class=char>U+002D</code>
384              <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>)
385              character.  If the argument is a keyword <code>odd</code>,
386              <var>b</var> is <code>1</code>.  If the argument
387              is a keyword <code>even</code>, <var>b</var> is
388              <code>0</code>.  If <var>b</var> is omitted, it is assumed as
389              <code>0</code>.  The sign of <code>0</code>
390              <em class=rfc2119>MUST</em> be <code class=char>U+002B</code>
391              <code class=charname>PLUS SIGN</code>
392              (<code class=char>+</code>).</li>
393              <li>Append a <code class=char>U+0029</code>
394              <code class=charname>RIGHT PARENTHESIS</code>
395              (<code class=char>)</code>) character
396              to <var>result</var>.</li>
397              </ol>
398            </dd>
399          <dt>If the name of the pseudo$B!>(Bclass is <code>not</code></dt>
400            <dd>
401              <ol>
402                <li>Append a string of <code class=char>U+003A</code>
403                <code class=charname>COLON</code>, <code class=char>U+006E</code>
404                <code class=charname>LATIN SMALL LETTER N</code>,
405                <code class=char>U+006F</code> <code class=charname>LATIN
406                SMALL LETTER O</code>, <code class=char>U+0074</code>
407                <code class=charname>LATIN SMALL LETTER T</code>, and
408                <code class=char>U+0028</code> <code class=charname>LEFT
409                PARENTHESIS</code> (<code>:not(</code>), followed by a
410                <a href="#newline">newline</a>, to <var>result</var>.</li>
411                <li>Append four <code class=char>U+0020</code>
412                <code class=charname>SPACE</code> characters to
413                <var>result</var>.</li>
414                <li>Append four <code class=char>U+0020</code>
415                <code class=charname>SPACE</code> characters to
416                <var>result</var> again.</li>
417                <li><a href="#algorithm-serialize-a-simple-selector">Serialize
418                the simple selector specified as the argument to the
419                <code>not</code> pseudo$B!>(Bclass</a>.</li>
420                <li>Append a <a href="#newline">newline</a> to
421                <var>result</var>.</li>
422                <li>Append four <code class=char>U+0020</code>
423                <code class=charname>SPACE</code> characters to
424                <var>result</var>.</li>
425                <li>Append a <code class=char>U+0029</code>
426                <code class=charname>RIGHT PARENTHESIS</code>
427                (<code class=char>)</code>) character
428                to <var>result</var>.</li>
429              </ol>
430            </dd>
431          </dl>
432        </li>
433        </ol>
434      </dd>
435    <dt>If <var>ss</var> is a pseudo$B!>(Belement</dt>
436      <dd>
437        <ol>
438        <li>Append two <code class=char>U+003A</code>
439        <code class=charname>COLON</code> characters (<code>::</code>)
440        to <var>result</var>.</li>
441        <li>Append the
442        <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
443        name of the pseudo$B!>(Belement to <var>result</var>.</li>
444        <!-- For future version: append "(", arguments, ")", if any. -->
445        </ol>
446      </dd>
447  </dl>  </dl>
448    
449    <p>To <dfn id=algorithm-normalize-an-ident title="normalize an IDENT">normalize
450    an <code>IDENT</code> (<dfn id=var-n><var>n</var></dfn>)</dfn>:</p>
451    <ol>
452    <li>Replace the escape sequences (<code>\</code> and following
453    characters) in <var>n</var> by characters represented by them
454    respectively.</li>
455    <li>If there is any character that is <em>not</em> one of
456    <code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code>
457    (<code class=char>-</code>), <code class=char>U+0030</code>
458    <code class=charname>DIGIT ZERO</code>
459    (<code class=char>0</code>) to <code class=char>U+0039</code>
460    <code class=charname>DIGIT NINE</code> (<code class=char>9</code>),
461    <code class=char>U+0041</code> <code class=charname>LATIN CAPITAL LETTER
462    A</code> (<code class=char>A</code>) to <code class=char>U+005A</code>
463    <code class=charname>LATIN CAPITAL LETTER Z</code> (<code class=char>Z</code>),
464    <code class=char>U+005F</code> <code class=charname>LOW LINE</code>
465    (<code class=char>_</code>), <code class=char>U+0061</code>
466    <code class=charname>LATIN SMALL LETTER A</code>
467    (<code class=char>a</code>) to <code class=char>U+006A</code>
468    <code class=charname>LATIN SMALL LETTER Z</code> (<code class=char>z</code>),
469    <code class=char>U+0080</code> to <code class=char>U+D7FF</code>, or
470    <code class=char>U+E000</code> to <code class=char>U+10FFFF</code> in
471    <var>n</var>, then replace it by string <code>\<var>HHHHHH</var></code>, where
472    <dfn id=var-HHHHHH><var>HHHHHH</var></dfn> is the upper$B!>(Bcase zero$B!>(Bpadded
473    hexadecimal representation of the character.  If the character
474    is outside the range of <code>[<code class=char>U+0000</code>,
475    <code class=char>U+10FFFF</code>]</code>, <var>HHHHHH</var>
476    <em class=rfc2119>MUST</em> be <code>FFFFFF</code>.</li>
477    <li>If the first character in <var>n</var> is one of
478    <code class=char>U+0030</code> <code class=charname>DIGIT ZERO</code>
479    (<code class=char>0</code>) to <code class=char>U+0039</code>
480    <code class=charname>DIGIT NINE</code> (<code class=char>9</code>),
481    then prepend a string <code>\00003</code> at the beginning of
482    <var>n</var>.</li>
483    <li>If the first character in <var>n</var> is <code class=char>U+002D</code>
484    <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>) and
485    the second character, if any, is <em>not</em> one of
486    <code class=char>U+0041</code> <code class=charname>LATIN CAPITAL LETTER
487    A</code> (<code class=char>A</code>) to <code class=char>U+005A</code>
488    <code class=charname>LATIN CAPITAL LETTER Z</code> (<code class=char>Z</code>),
489    <code class=char>U+005F</code> <code class=charname>LOW LINE</code>
490    (<code class=char>_</code>), <code class=char>U+0061</code>
491    <code class=charname>LATIN SMALL LETTER A</code>
492    (<code class=char>a</code>) to <code class=char>U+006A</code>
493    <code class=charname>LATIN SMALL LETTER Z</code> (<code class=char>z</code>),
494    <code>U+0080</code> to <code>U+D7FF</code>, or
495    <code>U+E000</code> to <code>U+10FFFF</code>, or
496    <var>n</var> is equal to <code class=char>U+002D</code>
497    <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>), then
498    replace the <code class=char>U+002D</code>
499    <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>)
500    character by string <code>\00002D</code>.</li>
501    <li>Then, <var>n</var> is the result of the algorithm.</li>
502    </ol>
503    
504    <p>To <dfn id=algorithm-normalize-a-string title="normalize a STRING">normalize
505    a <code>STRING</code> (<dfn id=var-s><var>s</var></dfn>)</dfn>:</p>
506    <ol>
507    <li>Replace the escape sequences (<code>\</code> and following
508    characters) in <var>s</var> by characters represented by them
509    (or an empty string if <code>\</code> is immediately followed by
510    newline character(s)) respectively.</li>
511    <li>Remove the quotation characters in <var>s</var>
512    if <var>s</var> is a <code>STRING</code>.</li>
513    <li>If there is any character that is <em>not</em> one of
514    <code class=char>U+0020</code> <code class=charname>SPACE</code>,
515    <code class=char>U+0021</code> <code class=charname>EXCLAMATION MARK</code>
516    (<code class=char>!</code>), <code class=char>U+0023</code>
517    <code class=charname>NUMBER SIGN</code> (<code class=char>#</code>) to
518    <code class=char>U+005B</code> <code class=charname>LEFT SQUARE
519    BRACKET</code>, <code class=char>U+005D</code> <code class=charname>RIGHT
520    SQUARE BRACKET</code> to <code class=char>U+D7FF</code>, or
521    <code class=char>U+E000</code> to <code class=char>U+10FFFF</code> in
522    <var>s</var>, then replace it by string <code>\<var>HHHHHH</var></code>, where
523    <dfn id=var-HHHHHH><var>HHHHHH</var></dfn> is the upper$B!>(Bcase zero$B!>(Bpadded
524    hexadecimal representation of the character.  If the character
525    is outside the range of <code>[<code class=char>U+0000</code>,
526    <code class=char>U+10FFFF</code>]</code>, <var>HHHHHH</var>
527    <em class=rfc2119>MUST</em> be <code>FFFFFF</code>.</li>
528    <li>Insert a <code class=char>U+0022</code> <code class=charname>QUOTATION
529    MARK</code> (<code class=char>"</code>) at the beginning of <var>s</var>.</li>
530    <li>Insert a <code class=char>U+0022</code> <code class=charname>QUOTATION
531    MARK</code> (<code class=char>"</code>) at the end of <var>s</var>.</li>
532    <li>Then, <var>s</var> is the result of the algorithm.</li>
533    </ol>
534    
535    <p>A <dfn id=newline title=newline>newline</dfn>
536    <em class=rfc2119>SHOULD</em> be represented as a
537    <code class=char>U+000A</code> <code class=charname>LINE FEED</code>
538    character.  However, depending on the context where
539    the <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
540    representation is in use, a sequence of
541    <code class=char>U+000D</code> <code class=charname>CARRIAGE RETURN</code>
542    followed by a <code class=char>U+000A</code>
543    <code class=charname>LINE FEED</code> (i.e. a
544    <code>CRLF</code> sequence) or a character
545    <code class=char>U+000D</code> <code class=charname>CARRIAGE RETURN</code>
546    <em class=rfc2119>MAY</em> be used as a <a href="#newline">newline</a> instead.
547    <a href="#newline">Newline</a> representations
548    <em class=rfc2119>SHOULD</em> be consistent in an
549    <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
550    representation.</p>
551    
552    <div class="note memo">
553    <p>Therefore, newlines must be normalized before
554    <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
555    representations are literally compared.</p>
556    </div>
557    
558  </div>  </div>
559    
560  <div class="section" id="parsing">  <div class="section" id="parsing">
561  <h2>Parsing  <h2>Parsing
562  <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>  <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
563  Groups of Selectors</h2>  Groups of Selectors</h2>
564    
565  <p>Since <a href="#serializing">the serializing algorithm</a> is  <p>Since <a href="#serializing">the serializing algorithm</a> is
566  so designed that it always output a valid  so designed that it always output a valid
567  <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of  <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of
568  selectors</a>, no special parser for  selectors</a>, no special parser for the
569  <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>  <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
570  is necessary.  Any conforming  representation is necessary.  Any conforming parser for
571  <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of  <a href="http://www.w3.org/TR/css3-selectors/#grouping">groups of
572  selectors</a> parser <em class=rfc2119>MAY</em> be used  selectors</a> <em class=rfc2119>MAY</em> be used
573  to parse <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>  to parse <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
574  groups of selectors.</p>  representations of groups of selectors.</p>
575  </div>  </div>
576    
577  <div class="section" id="examples">  <div class="section" id="examples">
578  <h2>Examples</h2>  <h2>Examples</h2>
579    
580  <p class=section-info>This section is <em>non-normative</em>.</p>  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>
581    
582  <div class="ed issue">  <div class="ed issue">
583  <p><a href="http://suika.fam.cx/gate/2007/css/parser-interface">Try demo</a>,  <p><a href="http://suika.fam.cx/gate/2007/css/parser-interface">Try demo</a>,
584  by choosing <q>Selectors</q> radio button.</a></p>  by choosing <q>Selectors</q> radio button.</p>
585    
586  <div class="example figure block">  <div class="example figure block">
587  <div class="caption">...</div>  <div class="caption">...</div>
# Line 273  by choosing <q>Selectors</q> radio butto Line 594  by choosing <q>Selectors</q> radio butto
594  </div>  </div>
595    
596  <div id="references" class="section reference">  <div id="references" class="section reference">
597  <h2>References</h1>  <h2>References</h2>
598    
599  <div id="normative-references" class="section normative reference">  <div id="normative-references" class="section normative reference">
600  <h3>Normative References</h3>  <h3>Normative References</h3>
# Line 297  by choosing <q>Selectors</q> radio butto Line 618  by choosing <q>Selectors</q> radio butto
618  </div>  </div>
619    
620  <div id="informative-references" class="section informative reference">  <div id="informative-references" class="section informative reference">
621  <h3>Non-normative References</h3>  <h3>Non$B!>(Bnormative References</h3>
622    
623  <dl>  <dl>
624  <dt id=ref-CSS>CSS</dt>  <dt id=ref-CSS>CSS</dt>
# Line 328  by choosing <q>Selectors</q> radio butto Line 649  by choosing <q>Selectors</q> radio butto
649    <code class=URI>&lt;<a href="http://dev.w3.org/2006/webapi/selectors-api/Overview.html">http://dev.w3.org/2006/webapi/selectors-api/Overview.html</a>></code>.    <code class=URI>&lt;<a href="http://dev.w3.org/2006/webapi/selectors-api/Overview.html">http://dev.w3.org/2006/webapi/selectors-api/Overview.html</a>></code>.
650    The latest published version of the specification is available at    The latest published version of the specification is available at
651    <code class=URI>&lt;<a href="http://www.w3.org/TR/selectors-api/">http://www.w3.org/TR/selectors-api/</a>></code>.</dd>    <code class=URI>&lt;<a href="http://www.w3.org/TR/selectors-api/">http://www.w3.org/TR/selectors-api/</a>></code>.</dd>
652  <dt id=XBL2>XBL2</dt>  <dt id=ref-XBL2>XBL2</dt>
653    <dd><cite><a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr>XBL</abbr>    <dd><cite><a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr>XBL</abbr>
654    2.0</a></cite>, Mozilla.org, <time datetime=2007-03-15>15 Mar 2007</time>.    2.0</a></cite>, Mozilla.org, <time datetime=2007-03-15>15 Mar 2007</time>.
655    Work in progress.  The latest    Work in progress.  The latest
Legend:
Removed from v.1.6  
changed lines
  Added in v.1.11
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24