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

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

Parent Directory | Revision Log | View Patch Patch

-revision 1.18 by wakaba,
Sun Oct 28 07:19:15 2007 UTC
+revision 1.26 by wakaba,
Mon Nov  5 11:37:27 2007 UTC
 Line 10
  <div class="header">
  <h1>Selectors Serialization Format for Testing (<abbr>SSFT</abbr>)
  Specification</h1>
- <h2>Working Draft <time datetime=2007-10-28>28 October 2007</time></h2>
+ <h2>First Edition <!-- Working Draft -->
+ <time datetime=2007-11-05>5 November 2007</time></h2>
  <dl class="versions-uri">
  <dt>This Version</dt>
-   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/selectors/ssft/ssft"
+   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/selectors/ssft/ssft-20071105"
-       >http://suika.fam.cx/www/markup/selectors/ssft/ssft</a>&gt;</code></dd>
+       >http://suika.fam.cx/www/markup/selectors/ssft/ssft-20071105</a>&gt;</code></dd>
  <dt>Latest Version</dt>
    <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/selectors/ssft/ssft"
        >http://suika.fam.cx/www/markup/selectors/ssft/ssft</a>&gt;</code></dd>
- <!--
  <dt>Latest Working Draft</dt>
- -->
+   <dd><code class="URI">&lt;<a href="http://suika.fam.cx/www/markup/selectors/ssft/ssft-work"
+       >http://suika.fam.cx/www/markup/selectors/ssft/ssft-work</a>&gt;</code></dd>
  <!-- <dt>Previous Version</dt> -->
  <dt>Version History</dt>
-   <dd><code class=URI>&lt;<a href="http://suika.fam.cx/gate/cvs/markup/selectors/ssft/ssft.en.html">http://suika.fam.cx/gate/cvs/markup/selectors/ssft/ssft.en.html</a>&gt;</code></dd>
+   <dd><code class=URI>&lt;<a href="http://suika.fam.cx/gate/cvs/markup/selectors/ssft/ssft-work.en.html">http://suika.fam.cx/gate/cvs/markup/selectors/ssft/ssft-work.en.html</a>&gt;</code></dd>
  </dl>
  <dl class="authors" id="author">
  <dt>Author</dt>
-Line 52 
 available at <code class="URI">&lt;<a
+Line 53 
 available at <code class="URI">&lt;<a
  <div id="abstract" class="section">
  <h2>Abstract</h2>
- <div class="ed issue">...</div>
+ <p>This document defines
+ <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>,
+ a subset of Selectors language which is suitable for describing results
+ of Selectors parsing tests.</p>
  </div>
-Line 63 
 available at <code class="URI">&lt;<a
+Line 67 
 available at <code class="URI">&lt;<a
  at the time of its publication.  Other documents
  might supersede this document.</em></p>
- <p>This document is a working draft, produced as part of the
+ <p>This document is the specification
+ <!-- This document is a working draft -->
+ of <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>,
+ produced as part of the
  <a href="http://suika.fam.cx/www/markup/html/whatpm/readme">Whatpm</a>
  subproject
  of the <a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a>
- project.  It might be updated, replaced, or obsoleted by
+ project.
+ <!-- It might be updated, replaced, or obsoleted by
  other documents at any time.  It is inappropriate to
- cite this document as other than <q>work in progress</q>.</p>
+ cite this document as other than <q>work in progress</q>. --></p>
  <p>Comments on this document are welcome and
  may be sent to the <a href="#author">author</a>.</p>
-Line 125 
 to deploy that format for testing.</p>
+Line 133 
 to deploy that format for testing.</p>
  <p>The key words <q><dfn id=must><em class="rfc2119">MUST</em></dfn></q>,
  <q><dfn id=must-not><em class="rfc2119">MUST NOT</em></dfn></q>,
- <q><dfn id=should><em class="rfc2119">SHOULD</em></dfn></q>,
+ <q><dfn id=should><em class="rfc2119">SHOULD</em></dfn></q>, and
- <q><dfn id=should-not><em class="rfc2119">SHOULD NOT</em></dfn></q>, and
  <q><dfn id=may><em class=rfc2119>MAY</em></dfn></q> in this
  document are to be interpreted as described in
  <a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>
-Line 162 
 to <a href="#algorithm-serialize-a-simpl
+Line 169 
 to <a href="#algorithm-serialize-a-simpl
  selector</a> or <a href="#algorithm-serialize-a-group-of-selectors">serialize
  a group of selectors</a>.</p>
- <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>
  <div class="note memo">
  <p>The serialized representation will not contain any comment.</p>
  </div>
- <!-- TODO: link terms to Selectors -->
  <div class=section id=serializing-tokens>
  <h3>Serializing Tokens</h3>
-Line 202 
 A</code> (<code class=char>A</code>) to
+Line 203 
 A</code> (<code class=char>A</code>) to
  <code class=char>U+0080</code> to <code class=char>U+D7FF</code>, or
  <code class=char>U+E000</code> to <code class=char>U+10FFFF</code> in
  <var>n</var>, then replace it by string <code>\<var>HHHHHH</var></code>, where
- <dfn id=var-HHHHHH><var>HHHHHH</var></dfn> is the upper$B!>(Bcase zero$B!>(Bpadded
+ <dfn id=var-ident-HHHHHH><var>HHHHHH</var></dfn> is the uppercase
- hexadecimal representation of the character.  If the character
+ zero$B!>(Bpadded hexadecimal representation of the character.  If the character
  is outside the range of <code>[<code class=char>U+0000</code>,
  <code class=char>U+10FFFF</code>]</code>, <var>HHHHHH</var>
  <em class=rfc2119>MUST</em> be <code>FFFFFF</code>.</li>
-Line 255 
 BRACKET</code>, <code class=char>U+005D<
+Line 256 
 BRACKET</code>, <code class=char>U+005D<
  SQUARE BRACKET</code> to <code class=char>U+D7FF</code>, or
  <code class=char>U+E000</code> to <code class=char>U+10FFFF</code> in
  <var>s</var>, then replace it by string <code>\<var>HHHHHH</var></code>, where
- <dfn id=var-HHHHHH><var>HHHHHH</var></dfn> is the upper$B!>(Bcase zero$B!>(Bpadded
+ <dfn id=var-string-HHHHHH><var>HHHHHH</var></dfn> is the uppercase
- hexadecimal representation of the character.  If the character
+ zero$B!>(Bpadded hexadecimal representation of the character.  If the character
  is outside the range of <code>[<code class=char>U+0000</code>,
  <code class=char>U+10FFFF</code>]</code>, <var>HHHHHH</var>
  <em class=rfc2119>MUST</em> be <code>FFFFFF</code>.</p></li>
-Line 292 
 representations are literally compared.<
+Line 293 
 representations are literally compared.<
  </div>
  <div class="issue ed">
- <p>Need to define <dfn id=lower-case>lower$B!>(Bcase</dfn>.
+ <p>In a future version of the specification, we need to define
- It is tr/A-Z/a-z/ for now.</p>
+ <dfn id=lowercase>lowercase</dfn> (maybe by referencing some version of
+ some module of <abbr>CSS</abbr>).  It is <code>tr/A-Z/a-z/</code> for now.</p>
  </div>
+ <p>To
+ <dfn id=algorithm-normalize-an-integer title="normalize an integer">normalize
+ an integer (<dfn id=var-int-i><var>i</var></dfn>)</dfn>, the following
+ algorithm <em class=rfc2119>MUST</em> be used:</p>
+ <ol class=algorithm>
+ <li>If <var>i</var> is equal to zero (0), return a string with only a
+ character: <code class=char>U+0030</code>
+ <code class=charname>DIGIT ZERO</code> (<code class=char>0</code>).
+ Stop the algorithm.</li>
+ <li>Let <dfn id=var-int-result><var>result</var></dfn> be an empty string.</li>
+ <li>If <var>i</var> is less than zero (0), append a
+ <code class=char>U+002D</code> <code class=charname>HYPHEN-MINUS</code>
+ (<code class=char>-</code>) character to <var>result</var>.</li>
+ <li>Append the decimal representation of the absolute value of
+ <var>i</var> to <var>result</var>.  The decimal (base$B!>(Bten) representation
+ <em class=rfc2119>MUST NOT</em> begin with a <code class=char>U+0030</code>
+ <code class=charname>DIGIT ZERO</code> (<code class=char>0</code>)
+ character.</li>
+ <li>Return <var>result</var>.</li>
+ </ol>
  </div>
-Line 416 
 the following algorithm <em class=rfc211
+Line 439 
 the following algorithm <em class=rfc211
      to <var>r</var>.</li>
      <li>Append the
      <a href="#algorithm-normalize-an-ident" title="normalize a string (IDENT) as an IDENT">normalized</a>
-     name (in <a href="#lower-case">lower$B!>(Bcase</a>) of the pseudo$B!>(Bclass to
+     name (in <a href="#lowercase">lowercase</a>) of the pseudo$B!>(Bclass to
      <var>r</var>.</li>
      <li>Append any arguments as following:
        <dl class=switch>
-Line 460 
 the following algorithm <em class=rfc211
+Line 483 
 the following algorithm <em class=rfc211
            <li>Append a <code class=char>U+0028</code> <code class=charname>LEFT
            PARENTHESIS</code> (<code class=char>(</code>) character
            to <var>r</var>.</li>
-           <li>Append <span class=ed>@@ normalized</span>
+           <li>Let <dfn id=var-a><var>a</var></dfn> be the <var>a</var>
-           integer <var>a</var> to <var>r</var>.
+           part of the argument.  If the argument is a keyword <code>odd</code>
-           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>.
-           <var>a</var> is <code>2</code>.  If <var>a</var> and
+           If the <var>a</var> part with following <code>n</code> character
-           <code>n</code> is omitted, <var>a</var> is assumed as
+           is omitted, then let <var>a</var> be <code>0</code>.
-           <code>0</code>.  Otherwise, if <var>a</var> is omitted,
+           Otherwise, if only the <var>a</var> part is omitted, then
-           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>
-           if there is a <code class=char>U+002D</code>
+           part is <code>-</code>, then let <var>a</var> be
-           <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>)
+           <code>-1</code>.</li>
-           character).</li>
+           <li>Let <var>a</var> be the
+           <a href="#algorithm-normalize-an-integer" title="normalize an integer">normalized
+           string representation</a> of integer <var>a</var>.</li>
+           <li>Append <var>a</var> to <var>r</var>.</li>
            <li>Append a <code class=char>U+006E</code>
            <code class=charname>LATIN SMALL LETTER N</code>
            (<code class=char>n</code>) character to <var>r</var>.</li>
-           <li>Append <span class=ed>@@ normalized</span>
+           <li>Let <dfn id=var-b><var>b</var></dfn> be the <var>b</var>
-           integer <var>b</var> to <var>r</var>.
+           part of the argument.  If the argument is a keyword <code>odd</code>,
-           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
-           either <code class=char>U+002B</code> <code class=charname>PLUS
+           keyword <code>even</code>, then let <var>b</var> be <code>0</code>.
-           SIGN</code> (<code class=char>+</code>) or
+           If the <var>b</var> part is omitted, then let <var>b</var> be
-           <code class=char>U+002D</code>
+           <code>0</code>.</li>
+           <li>Let <var>b</var> be the
+           <a href="#algorithm-normalize-an-integer" title="normalize an integer">normalized
+           string representation</a> of integer <var>b</var>.</li>
+           <li>If <var>b</var> does <em>not</em> start with a
+           <code class=char>U+002D</code>
            <code class=charname>HYPHEN-MINUS</code> (<code class=char>-</code>)
-           character.  If the argument is a keyword <code>odd</code>,
+           character, then append <code class=char>U+002B</code>
-           <var>b</var> is <code>1</code>.  If the argument
+           <code class=charname>PLUS SIGN</code>
-           is a keyword <code>even</code>, <var>b</var> is
+           (<code class=char>+</code>) to <var>r</var>.</li>
-           <code>0</code>.  If <var>b</var> is omitted, it is assumed as
+           <li>Append <var>b</var> to <var>r</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>
            <li>Append a <code class=char>U+0029</code>
            <code class=charname>RIGHT PARENTHESIS</code>
            (<code class=char>)</code>) character
-Line 544 
 the following algorithm <em class=rfc211
+Line 571 
 the following algorithm <em class=rfc211
      to <var>r</var>.</li>
      <li>Append the
      <a href="#algorithm-normalize-an-ident" title="normalize a string (IDENT) as an IDENT">normalized</a>
-     name (in <a href="#lower-case">lower$B!>(Bcase</a>) of the pseudo$B!>(Belement
+     name (in <a href="#lowercase">lowercase</a>) of the pseudo$B!>(Belement
      to <var>r</var>.</li>
      <li>If the pseudo$B!>(Belement has any arguments:
          The pseudo$B!>(Belement is not supported by this version of
-Line 594 
 the following algorithm <em class=rfc211
+Line 621 
 the following algorithm <em class=rfc211
      (<dfn id=var-sss><var>sss</var></dfn>)</dt>
        <dd>
          <ol>
-         <li class=ed><a href="#algorithm-serialize-a-simple-selector">Serialize
+         <li>If <var>sss</var> contains a universal or type selector, then
-         each simple selector</a> in <var>sss</var>.</li>
+         <a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">serialize
-         <li class=ed>sort</li>
+         that simple selector</a> and append the result to
+         <var>result</var>.</li>
+         <li>Otherwise, i.e. if <var>sss</var> does not contain a universal or
+         type selector, then
+         <a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">serialize
+         a simple selector <code>*</code></a> and append the result to
+         <var>result</var>.</li>
+         <li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize
+         any attribute selectors</a> in <var>sss</var>, sort the results,
+         then append them to <var>result</var> in order.</li>
+         <li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize
+         any class selectors</a> in <var>sss</var>, sort the results,
+         then append them to <var>result</var> in order.</li>
+         <li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize
+         any <abbr>ID</abbr> selectors</a> in <var>sss</var>, sort the results,
+         then append them to <var>result</var> in order.</li>
+         <li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize
+         any pseudo$B!>(Bclass selectors</a> in <var>sss</var>, sort the results,
+         then append them to <var>result</var> in order.</li>
+         <li><a href="#algorithm-serialize-a-simple-selector" title="serialize a simple selector">Serialize
+         any pseudo elements</a> in <var>sss</var>, sort the results,
+         then append them to <var>result</var> in order.</li>
          <li>Append a <a href="#newline">newline</a> to <var>result</var>.</li>
          </ol>
        </dd>
-Line 678 
 representations of <a href="#simple-sele
+Line 726 
 representations of <a href="#simple-sele
  <p class=section-info>This section is <em>non$B!>(Bnormative</em>.</p>
- <div class="ed issue">
- <p><a href="http://suika.fam.cx/gate/2007/css/parser-interface">Try demo</a>,
- by choosing <q>Selectors</q> radio button.</p>
  <div class="example figure block">
- <div class="caption">...</div>
+ <p>The <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
+ representation of a selector <code>p + q</code> is:</p>
- <pre><code>...</code></pre>
+ <pre><code>    *|p
+   + *|q
+ </code></pre>
  </div>
+ <div class="example figure block">
+ <p>The <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
+ representation of a selector <code>a#id.class1:n\ot(:Active)/*
+  comment
+ */.class2</code> is:</p>
+ <pre><code>    *|a.class1.class2#id:not(
+         :active
+     )
+ </code></pre>
+ </div>
+ <div class="example figure block">
+ <p>The <abbr title="Selectors Serialization Format for Testing">SSFT</abbr>
+ representation of a
+ <a href="http://www.w3.org/TR/css3-selectors/#grouping">group of selectors</a>
+ <code>a, #b, C[d^=e], .\31 23</code> is:</p>
+ <pre><code>    *|a
+ ,
+     *|*#b
+ ,
+     *|C[|d^="e"]
+ ,
+     *|*.\00003123
+ </code></pre>
  </div>
  </div>
-Line 739 
 by choosing <q>Selectors</q> radio butto
+Line 812 
 by choosing <q>Selectors</q> radio butto
  <dt id=ref-HTML5>HTML5</dt>
    <dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>,
    <abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>
-   Working Draft.  Work in progress.</dd>
+   Working Draft, <time datetime="2007-11-03">3 November 2007</time>.
+   Work in progress.</dd>
  <dt id=ref-SAPI>SAPI</dt>
    <dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/selectors-api/Overview.html?rev=1.28&amp;content-type=text/html;%20charset=utf-8">Selectors <abbr>API</abbr></a></cite>,
    <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,

 Legend:



Removed from v.1.18
 


changed lines


 
Added in v.1.26
 Legend:



Removed from v.1.18
 


changed lines


 
Added in v.1.26
-Removed from v.1.18
+Added in v.1.26

admin@suikawiki.org	ViewVC Help
Powered by ViewVC 1.1.24