/[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.12 by wakaba, Mon Oct 22 10:38:19 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">
143  <h2>Serializing Groups of Selectors</h2>  <h2>Serializing in
144    <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
145    Representation</h2>
146    
147  <div class="issue ed">  <div class="issue ed">
148  <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 the reference implementation</a>
149  for now.</p>  for now.</p>
150  </div>  </div>
151    
152  <p><dfn id=newline>Newline</dfn> is <code class=char>U+000A</code>  <div class=section id=serializing-groups-of-selectors>
153  <code class=charname>LINE FEED</code> <span class=ed>or  <h3>Serializing Groups of Selectors</h3>
154  U+000D U+000A or U+000A ??</span>.</p>  
155    <p>No <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
156    representation is defined for an invalid group of selectors.</p>
157    
158    <div class="note memo">
159    <p>The serialized representation will not contain any comment.</p>
160    </div>
161    
162  <!-- TODO: link terms to Selectors -->  <!-- TODO: link terms to Selectors -->
163    
164  <p>To <dfn id=algorithm-serialize-a-group-of-selectors>serialize a group of  <p>To
165  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
166    a group of selectors (<dfn id=var-gs><var>gs</var></dfn>)</dfn>:</p>
167  <ol>  <ol>
168  <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>
169  <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 171  selectors</dfn> (<dfn id=var-gs><var>gs<
171    <ol>    <ol>
172    <li>If <var>selector</var> is <em>not</em> the first selector    <li>If <var>selector</var> is <em>not</em> the first selector
173    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>
174    <code class=charname>COMMA</code> followed by a    <code class=charname>COMMA</code> (<code class=char>,</code>) followed by a
175    <a href="#newline">newline</a> to <var>result</var>.</li>    <a href="#newline">newline</a> to <var>result</var>.</li>
176    <li>Append four <code class=char>U+0020</code>    <li>Append four <code class=char>U+0020</code>
177    <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 180  selectors</dfn> (<dfn id=var-gs><var>gs<
180      <dl class=switch>      <dl class=switch>
181      <dt>If it is a sequence of simle selector      <dt>If it is a sequence of simle selector
182      (<dfn id=var-sss><var>sss</var></dfn>)</dt>      (<dfn id=var-sss><var>sss</var></dfn>)</dt>
183        <dd class=ed>@@</dd>        <dd>
184            <ol>
185            <li class=ed><a href="#algorithm-serialize-a-simple-selector">Serialize
186            each simple selector</a> in <var>sss</var>.</li>
187            <li class=ed>sort</li>
188            <li>Append a <a href="#newline">newline</a> to <var>result</var>.</li>
189            </ol>
190          </dd>
191      <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>
192        <dd>        <dd>
193          <ol>          <ol>
# Line 179  selectors</dfn> (<dfn id=var-gs><var>gs< Line 202  selectors</dfn> (<dfn id=var-gs><var>gs<
202            <dt>If <var>c</var> is child combinator            <dt>If <var>c</var> is child combinator
203            (<code class=char>></code>)</dt>            (<code class=char>></code>)</dt>
204              <dd>Append a <code class=char>U+003E</code>              <dd>Append a <code class=char>U+003E</code>
205              <code class=charname>GREATER-THAN SIGN</code> character to              <code class=charname>GREATER-THAN SIGN</code>
206              <var>result</var>.</dd>              (<code class=char>></code>) character to <var>result</var>.</dd>
207            <dt>If <var>c</var> is adjacent sibling combinator            <dt>If <var>c</var> is adjacent sibling combinator
208            (<code class=char>+</code>)</dt>            (<code class=char>+</code>)</dt>
209              <dd>Append a <code class=char>U+002B</code>              <dd>Append a <code class=char>U+002B</code>
210              <code class=charname>PLUS SIGN</code> character to              <code class=charname>PLUS SIGN</code> (<code class=char>+</code>)
211              <var>result</var>.</dd>              character to <var>result</var>.</dd>
212            <dt>If <var>c</var> is general sibling combinator            <dt>If <var>c</var> is general sibling combinator
213            (<code class=char>~</code>)</dt>            (<code class=char>~</code>)</dt>
214              <dd>Append a <code class=char>U+007E</code>              <dd>Append a <code class=char>U+007E</code>
215              <code class=charname>TILDE</code> character to              <code class=charname>TILDE</code> (<code class=char>~</code>)
216              <var>result</var>.</dd>              character to <var>result</var>.</dd>
217            </dl>            </dl>
218          </li>          </li>
219          <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 225  selectors</dfn> (<dfn id=var-gs><var>gs<
225    </ol>    </ol>
226  </li>  </li>
227  <li>Then, <var>result</var> is the  <li>Then, <var>result</var> is the
228  <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>  <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
229  representation of the group of selectors.</li>  representation of <var>gs</var>.</li>
230  </ol>  </ol>
231    
232  <p>To <dfn id=algorithm-serialize-a-simple-selector>serialize a simple  </div>
233  selector</dfn> (<dfn><var id=var-ss>ss</var></dfn>):</p>  
234    <div class=section id=serializing-simple-selectors>
235    <h3>Serializing Simple Selectors</h3>
236    
237    <p>To
238    <dfn id=algorithm-serialize-a-simple-selector title="serialize a simple selector">serialize
239    a simple selector (<dfn><var id=var-ss>ss</var></dfn>)</dfn>:</p>
240  <dl class=switch>  <dl class=switch>
241  <dt>If <var>ss</var> is a type or universal selector</dt>  <dt>If <var>ss</var> is a type or universal selector</dt>
242    <dd><dl class=switch>    <dd>
243    <dt>If a namespace URI is specified (via namespace prefix, or      <ol>
244    by omitting namespace prefix where a default namespace is specified)</dt>      <li>
245      <dd class="ed">@@</dd>        <dl class=switch>
246    <dt>If the null namespace is specified (by zero$B!>(Blength namespace        <dt>If a namespace URI is specified (via namespace prefix, or
247    prefix)</dt>        by omitting namespace prefix where a default namespace is specified)</dt>
248      <dd>Return a <code class=char>U+007C</code> <code class=charname>VERTICAL          <dd class="ed">@@</dd>
249      BAR</code> character, followed by either local name (if <var>ss</var>        <dt>If the null namespace is specified (by zero$B!>(Blength namespace
250      is a type selector) or a <code class=char>U+002A</code>        prefix)</dt>
251      <code class=charname>ASTERISK</code> character (if <var>ss</var>          <dd>Append a <code class=char>U+007C</code>
252      is a universal selector).</dd>          <code class=charname>VERTICAL BAR</code> (<code class=char>|</code>)
253    <dt>If no namespace is specified (by namespace prefix <code>*</code>,          character to <var>result</var>.</dd>
254    or by omitting namespace prefix where no default namespace is specified)</dt>        <dt>If no namespace is specified (by namespace prefix <code>*</code>,
255      <dd>Return a <code class=char>U+002A</code>        or by omitting namespace prefix where no default namespace is
256      <code class=charname>ASTERISK</code> character, followed by a        specified)</dt>
257      <code class=char>U+007C</code> <code class=charname>VERTICAL BAR</code>          <dd>Append a <code class=char>U+002A</code>
258      character, followed by either local name (if <var>ss</var>          <code class=charname>ASTERISK</code> (<code class=char>*</code>)
259      is a type selector) or a <code class=char>U+002A</code>          character, followed by a <code class=char>U+007C</code>
260      <code class=charname>ASTERISK</code> character (if <var>ss</var>          <code class=charname>VERTICAL BAR</code> (<code class=char>|</code>)
261      is a universal selector).</dd>          character, to <var>result</var>.</dd>
262    </dl></dd>        </dl>
263  <dt class=ed>@@</dt>      </li>
264        <li>If <var>ss</var> is a type selector, append the
265        <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
266        local name to <var>result</var>.</li>
267        <li>If <var>ss</var> is a universal selector, append
268        a <code class=char>U+002A</code> <code class=charname>ASTERISK</code>
269        (<code class=char>*</code>) character to <var>result</var>.</li>
270        </ol>
271      </dd>
272    <dt>If <var>ss</var> is an attribute selector</dt>
273      <dd>
274        <ol>
275        <li>Append a <code class=char>U+005B</code> <code class=charname>LEFT
276        SQUARE BRACKET</code> (<code class=char>[</code>) to
277        <var>result</var>.</li>
278        <li>
279          Append a namespace prefix as following:
280          <dl>
281          <dt>If a namespace URI is specified</dt>
282            <dd class=ed>@@</dd>
283            <dd class=ed>@@ Current reference implementation is wrong,
284            since its result of sorting depends on namespace prefix.</dd>
285          <dt>If the null namespace is specified</dt>
286            <dd>Append a <code class=char>U+007C</code>
287            <code class=charname>VERTICAL BAR</code> character to
288            <var>result</var>.</dd>
289          <dt>If no namespace is specified</dt>
290            <dd>Append a <code class=char>U+002A</code>
291            <code class=charname>ASTERISK</code> (<code class=char>*</code>)
292            character, followed by a <code class=char>U+007C</code>
293            <code class=charname>VERTICAL BAR</code> (<code class=char>|</code>)
294            character, to <var>result</var>.</dd>
295          </dl>
296        </li>
297        <li>Append the
298        <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
299        local name to <var>result</var>.</li>
300        <li>If a value is specified in <var>ss</var>:
301          <ol>
302          <li>Depending on the way to match, append <code>=</code>,
303          <code>~=</code>, <code>|=</code>, <code>^=</code>,
304          <code>$=</code>, or <code>*=</code> to <var>result</var>.</li>
305          <li>Append the
306          <a href="#algorithm-normalize-a-string" title="normalize a string">normalized</a>
307          value to <var>result</var>.</li>
308          </ol>
309        </li>
310        <li>Append a <code class=char>U+005D</code> <code class=charname>RIGHT
311        SQUARE BRACKET</code> (<code class=char>]</code>) to
312        <var>result</var>.</li>
313        </ol>
314      </dd>
315    <dt>If <var>ss</var> is a class selector</dt>
316      <dd>Append a <code class=char>U+002E</code> <code class=charname>FULL
317      STOP</code> (<code class=char>.</code>) character, followed
318      by <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
319      class name, <var>result</var>.</dd>
320    <dt>If <var>ss</var> is an <abbr>ID</abbr> selector</dt>
321      <dd>Append a <code class=char>U+0023</code> <code class=charname>NUMBER
322      SIGN</code> (<code class=char>#</code>) character, followed
323      by <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
324      <abbr>ID</abbr>, to <var>result</var>.</dd>
325    <dt>If <var>ss</var> is a pseudo$B!>(Bclass selector</dt>
326      <dd>
327        <ol>
328        <li>Append a <code class=char>U+003A</code>
329        <code class=charname>COLON</code> (<code class=char>:</code>) character
330        to <var>result</var>.</li>
331        <li>Append the
332        <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
333        name of the pseudo$B!>(Bclass to <var>result</var>.</li>
334        <li>Append any arguments as following:
335          <dl class=switch>
336          <dt>If the name of the pseudo$B!>(Bclass is <code>lang</code></dt>
337            <dd>
338              <ol>
339              <li>Append a <code class=char>U+0028</code> <code class=charname>LEFT
340              PARENTHESIS</code> (<code class=char>(</code>) character
341              to <var>result</var>.</li>
342              <li>Append the
343              <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
344              language tag (the argument) to <var>result</var>.</li>
345              <li>Append a <code class=char>U+0029</code>
346              <code class=charname>RIGHT PARENTHESIS</code>
347              (<code class=char>)</code>) character
348              to <var>result</var>.</li>
349              </ol>
350            </dd>
351          <dt>If the name of the pseudo$B!>(Bclass is
352          <code>-manakai-contains</code></dt>
353            <dd>
354              <ol>
355              <li>Append a <code class=char>U+0028</code> <code class=charname>LEFT
356              PARENTHESIS</code> (<code class=char>(</code>) character
357              to <var>result</var>.</li>
358              <li>Append the
359              <a href="#algorithm-normalize-a-string" title="normalize a string">normalized</a>
360              string (the argument) to <var>result</var>.</li>
361              <li>Append a <code class=char>U+0029</code>
362              <code class=charname>RIGHT PARENTHESIS</code>
363              (<code class=char>)</code>) character
364              to <var>result</var>.</li>
365              </ol>
366            </dd>
367          <dt>If name of the pseudo$B!>(Bclass is either <code>nth-child</code>,
368          <code>nth-last-child</code>, <code>nth-of-type</code>, or
369          <code>nth-last-of-type</code></dt>
370            <dd>
371              <ol>
372              <li>Append a <code class=char>U+0028</code> <code class=charname>LEFT
373              PARENTHESIS</code> (<code class=char>(</code>) character
374              to <var>result</var>.</li>
375              <li>Append <span class=ed>@@ normalized</span>
376              integer <var>a</var> to <var>result</var>.
377              If the argument is a keyword <code>odd</code> or <code>even</code>,
378              <var>a</var> is <code>2</code>.  If <var>a</var> and
379              <code>n</code> is omitted, <var>a</var> is assumed as
380              <code>0</code>.  Otherwise, if <var>a</var> is omitted,
381              it is assumed as <code>1</code> (or <code>-1</code>,
382              if there is a <code class=char>U+002D</code>
383              <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>)
384              character).</li>
385              <li>Append a <code class=char>U+006E</code>
386              <code class=charname>LATIN SMALL LETTER N</code>
387              (<code class=char>n</code>) character to <var>result</var>.</li>
388              <li>Append <span class=ed>@@ normalized</span>
389              integer <var>b</var> to <var>result</var>.
390              It <em class=rfc2119>MUST</em> be preceded by a sign,
391              either <code class=char>U+002B</code> <code class=charname>PLUS
392              SIGN</code> (<code class=char>+</code>) or
393              <code class=char>U+002D</code>
394              <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>)
395              character.  If the argument is a keyword <code>odd</code>,
396              <var>b</var> is <code>1</code>.  If the argument
397              is a keyword <code>even</code>, <var>b</var> is
398              <code>0</code>.  If <var>b</var> is omitted, it is assumed as
399              <code>0</code>.  The sign of <code>0</code>
400              <em class=rfc2119>MUST</em> be <code class=char>U+002B</code>
401              <code class=charname>PLUS SIGN</code>
402              (<code class=char>+</code>).</li>
403              <li>Append a <code class=char>U+0029</code>
404              <code class=charname>RIGHT PARENTHESIS</code>
405              (<code class=char>)</code>) character
406              to <var>result</var>.</li>
407              </ol>
408            </dd>
409          <dt>If the name of the pseudo$B!>(Bclass is <code>not</code></dt>
410            <dd>
411              <ol>
412                <li>Append a string of <code class=char>U+003A</code>
413                <code class=charname>COLON</code>, <code class=char>U+006E</code>
414                <code class=charname>LATIN SMALL LETTER N</code>,
415                <code class=char>U+006F</code> <code class=charname>LATIN
416                SMALL LETTER O</code>, <code class=char>U+0074</code>
417                <code class=charname>LATIN SMALL LETTER T</code>, and
418                <code class=char>U+0028</code> <code class=charname>LEFT
419                PARENTHESIS</code> (<code>:not(</code>), followed by a
420                <a href="#newline">newline</a>, to <var>result</var>.</li>
421                <li>Append four <code class=char>U+0020</code>
422                <code class=charname>SPACE</code> characters to
423                <var>result</var>.</li>
424                <li>Append four <code class=char>U+0020</code>
425                <code class=charname>SPACE</code> characters to
426                <var>result</var> again.</li>
427                <li><a href="#algorithm-serialize-a-simple-selector">Serialize
428                the simple selector specified as the argument to the
429                <code>not</code> pseudo$B!>(Bclass</a>.</li>
430                <li>Append a <a href="#newline">newline</a> to
431                <var>result</var>.</li>
432                <li>Append four <code class=char>U+0020</code>
433                <code class=charname>SPACE</code> characters to
434                <var>result</var>.</li>
435                <li>Append a <code class=char>U+0029</code>
436                <code class=charname>RIGHT PARENTHESIS</code>
437                (<code class=char>)</code>) character
438                to <var>result</var>.</li>
439              </ol>
440            </dd>
441          </dl>
442        </li>
443        </ol>
444      </dd>
445    <dt>If <var>ss</var> is a pseudo$B!>(Belement</dt>
446      <dd>
447        <ol>
448        <li>Append two <code class=char>U+003A</code>
449        <code class=charname>COLON</code> characters (<code>::</code>)
450        to <var>result</var>.</li>
451        <li>Append the
452        <a href="#algorithm-normalize-an-ident" title="normalize an IDENT">normalized</a>
453        name of the pseudo$B!>(Belement to <var>result</var>.</li>
454        <!-- For future version: append "(", arguments, ")", if any. -->
455        </ol>
456      </dd>
457  </dl>  </dl>
458    
459  </div>  </div>
460    
461    <div class=section id=serializing-tokens>
462    <h3>Serializing Tokens</h3>
463    
464    <p>To <dfn id=algorithm-normalize-an-ident title="normalize an IDENT">normalize
465    an <code>IDENT</code> (<dfn id=var-n><var>n</var></dfn>)</dfn>:</p>
466    <ol>
467    <li>Replace the escape sequences (<code>\</code> and following
468    characters) in <var>n</var> by characters represented by them
469    respectively.</li>
470    <li>If there is any character that is <em>not</em> one of
471    <code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code>
472    (<code class=char>-</code>), <code class=char>U+0030</code>
473    <code class=charname>DIGIT ZERO</code>
474    (<code class=char>0</code>) to <code class=char>U+0039</code>
475    <code class=charname>DIGIT NINE</code> (<code class=char>9</code>),
476    <code class=char>U+0041</code> <code class=charname>LATIN CAPITAL LETTER
477    A</code> (<code class=char>A</code>) to <code class=char>U+005A</code>
478    <code class=charname>LATIN CAPITAL LETTER Z</code> (<code class=char>Z</code>),
479    <code class=char>U+005F</code> <code class=charname>LOW LINE</code>
480    (<code class=char>_</code>), <code class=char>U+0061</code>
481    <code class=charname>LATIN SMALL LETTER A</code>
482    (<code class=char>a</code>) to <code class=char>U+006A</code>
483    <code class=charname>LATIN SMALL LETTER Z</code> (<code class=char>z</code>),
484    <code class=char>U+0080</code> to <code class=char>U+D7FF</code>, or
485    <code class=char>U+E000</code> to <code class=char>U+10FFFF</code> in
486    <var>n</var>, then replace it by string <code>\<var>HHHHHH</var></code>, where
487    <dfn id=var-HHHHHH><var>HHHHHH</var></dfn> is the upper$B!>(Bcase zero$B!>(Bpadded
488    hexadecimal representation of the character.  If the character
489    is outside the range of <code>[<code class=char>U+0000</code>,
490    <code class=char>U+10FFFF</code>]</code>, <var>HHHHHH</var>
491    <em class=rfc2119>MUST</em> be <code>FFFFFF</code>.</li>
492    <li>If the first character in <var>n</var> is one of
493    <code class=char>U+0030</code> <code class=charname>DIGIT ZERO</code>
494    (<code class=char>0</code>) to <code class=char>U+0039</code>
495    <code class=charname>DIGIT NINE</code> (<code class=char>9</code>),
496    then prepend a string <code>\00003</code> at the beginning of
497    <var>n</var>.</li>
498    <li>If the first character in <var>n</var> is <code class=char>U+002D</code>
499    <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>) and
500    the second character, if any, is <em>not</em> one of
501    <code class=char>U+0041</code> <code class=charname>LATIN CAPITAL LETTER
502    A</code> (<code class=char>A</code>) to <code class=char>U+005A</code>
503    <code class=charname>LATIN CAPITAL LETTER Z</code> (<code class=char>Z</code>),
504    <code class=char>U+005F</code> <code class=charname>LOW LINE</code>
505    (<code class=char>_</code>), <code class=char>U+0061</code>
506    <code class=charname>LATIN SMALL LETTER A</code>
507    (<code class=char>a</code>) to <code class=char>U+006A</code>
508    <code class=charname>LATIN SMALL LETTER Z</code> (<code class=char>z</code>),
509    <code>U+0080</code> to <code>U+D7FF</code>, or
510    <code>U+E000</code> to <code>U+10FFFF</code>, or
511    <var>n</var> is equal to <code class=char>U+002D</code>
512    <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>), then
513    replace the <code class=char>U+002D</code>
514    <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>)
515    character by string <code>\00002D</code>.</li>
516    <li>Then, <var>n</var> is the result of the algorithm.</li>
517    </ol>
518    
519    <p>To <dfn id=algorithm-normalize-a-string title="normalize a STRING">normalize
520    a <code>STRING</code> (<dfn id=var-s><var>s</var></dfn>)</dfn>:</p>
521    <ol>
522    <li>Replace the escape sequences (<code>\</code> and following
523    characters) in <var>s</var> by characters represented by them
524    (or an empty string if <code>\</code> is immediately followed by
525    newline character(s)) respectively.</li>
526    <li>Remove the quotation characters in <var>s</var>
527    if <var>s</var> is a <code>STRING</code>.</li>
528    <li>If there is any character that is <em>not</em> one of
529    <code class=char>U+0020</code> <code class=charname>SPACE</code>,
530    <code class=char>U+0021</code> <code class=charname>EXCLAMATION MARK</code>
531    (<code class=char>!</code>), <code class=char>U+0023</code>
532    <code class=charname>NUMBER SIGN</code> (<code class=char>#</code>) to
533    <code class=char>U+005B</code> <code class=charname>LEFT SQUARE
534    BRACKET</code>, <code class=char>U+005D</code> <code class=charname>RIGHT
535    SQUARE BRACKET</code> to <code class=char>U+D7FF</code>, or
536    <code class=char>U+E000</code> to <code class=char>U+10FFFF</code> in
537    <var>s</var>, then replace it by string <code>\<var>HHHHHH</var></code>, where
538    <dfn id=var-HHHHHH><var>HHHHHH</var></dfn> is the upper$B!>(Bcase zero$B!>(Bpadded
539    hexadecimal representation of the character.  If the character
540    is outside the range of <code>[<code class=char>U+0000</code>,
541    <code class=char>U+10FFFF</code>]</code>, <var>HHHHHH</var>
542    <em class=rfc2119>MUST</em> be <code>FFFFFF</code>.</li>
543    <li>Insert a <code class=char>U+0022</code> <code class=charname>QUOTATION
544    MARK</code> (<code class=char>"</code>) at the beginning of <var>s</var>.</li>
545    <li>Insert a <code class=char>U+0022</code> <code class=charname>QUOTATION
546    MARK</code> (<code class=char>"</code>) at the end of <var>s</var>.</li>
547    <li>Then, <var>s</var> is the result of the algorithm.</li>
548    </ol>
549    
550    <p>A <dfn id=newline title=newline>newline</dfn>
551    <em class=rfc2119>SHOULD</em> be represented as a
552    <code class=char>U+000A</code> <code class=charname>LINE FEED</code>
553    character.  However, depending on the context where
554    the <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
555    representation is in use, a sequence of
556    <code class=char>U+000D</code> <code class=charname>CARRIAGE RETURN</code>
557    followed by a <code class=char>U+000A</code>
558    <code class=charname>LINE FEED</code> (i.e. a
559    <code>CRLF</code> sequence) or a character
560    <code class=char>U+000D</code> <code class=charname>CARRIAGE RETURN</code>
561    <em class=rfc2119>MAY</em> be used as a <a href="#newline">newline</a> instead.
562    <a href="#newline">Newline</a> representations
563    <em class=rfc2119>SHOULD</em> be consistent in an
564    <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
565    representation.</p>
566    
567    <div class="note memo">
568    <p>Therefore, newlines must be normalized before
569    <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
570    representations are literally compared.</p>
571    </div>
572    
573    </div>
574    
575    </div>
576    
577  <div class="section" id="parsing">  <div class="section" id="parsing">
578  <h2>Parsing  <h2>Parsing
579  <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>  <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
580  Groups of Selectors</h2>  Groups of Selectors</h2>
581    
582  <p>Since <a href="#serializing">the serializing algorithm</a> is  <p>Since <a href="#serializing">the serializing algorithm</a> is
583  so designed that it always output a valid  so designed that it always output a valid
584  <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of  <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of
585  selectors</a>, no special parser for  selectors</a>, no special parser for the
586  <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>  <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
587  is necessary.  Any conforming  representation is necessary.  Any conforming parser for
588  <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of  <a href="http://www.w3.org/TR/css3-selectors/#grouping">groups of
589  selectors</a> parser <em class=rfc2119>MAY</em> be used  selectors</a> <em class=rfc2119>MAY</em> be used
590  to parse <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>  to parse <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
591  groups of selectors.</p>  representations of groups of selectors.</p>
592  </div>  </div>
593    
594  <div class="section" id="examples">  <div class="section" id="examples">
595  <h2>Examples</h2>  <h2>Examples</h2>
596    
597  <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>
598    
599  <div class="ed issue">  <div class="ed issue">
600  <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>,
601  by choosing <q>Selectors</q> radio button.</a></p>  by choosing <q>Selectors</q> radio button.</p>
602    
603  <div class="example figure block">  <div class="example figure block">
604  <div class="caption">...</div>  <div class="caption">...</div>
# Line 273  by choosing <q>Selectors</q> radio butto Line 611  by choosing <q>Selectors</q> radio butto
611  </div>  </div>
612    
613  <div id="references" class="section reference">  <div id="references" class="section reference">
614  <h2>References</h1>  <h2>References</h2>
615    
616  <div id="normative-references" class="section normative reference">  <div id="normative-references" class="section normative reference">
617  <h3>Normative References</h3>  <h3>Normative References</h3>
# Line 297  by choosing <q>Selectors</q> radio butto Line 635  by choosing <q>Selectors</q> radio butto
635  </div>  </div>
636    
637  <div id="informative-references" class="section informative reference">  <div id="informative-references" class="section informative reference">
638  <h3>Non-normative References</h3>  <h3>Non$B!>(Bnormative References</h3>
639    
640  <dl>  <dl>
641  <dt id=ref-CSS>CSS</dt>  <dt id=ref-CSS>CSS</dt>
# Line 328  by choosing <q>Selectors</q> radio butto Line 666  by choosing <q>Selectors</q> radio butto
666    <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>.
667    The latest published version of the specification is available at    The latest published version of the specification is available at
668    <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>
669  <dt id=XBL2>XBL2</dt>  <dt id=ref-XBL2>XBL2</dt>
670    <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>
671    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>.
672    Work in progress.  The latest    Work in progress.  The latest
Legend:
Removed from v.1.6  
changed lines
  Added in v.1.12
admin@suikawiki.org
 ViewVC Help
Powered by ViewVC 1.1.24