selectors/ssft/ssft-work.en.html

<!DOCTYPE html>
<html lang="en" class="formal-specification status-work-in-progress">
<head>
<title>Selectors Serialization Format for Testing (SSFT) Specification</title>
<link rel="stylesheet" href="http://suika.fam.cx/www/style/html/spec">
<link rel="license" href="http://suika.fam.cx/c/gnu/fdl">
</head>
<body class="has-abstract">

<div class="header">
<h1>Selectors Serialization Format for Testing (<abbr>SSFT</abbr>)
Specification</h1>
<h2>Working Draft <time datetime=2007-10-02>2 October 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"
      >http://suika.fam.cx/www/markup/selectors/ssft/ssft</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>
-->
<!-- <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>
</dl>
<dl class="authors" id="author">
<dt>Author</dt>
  <dd><a href="http://suika.fam.cx/~wakaba/who?" rel="author"
      lang=ja>Wakaba</a>
  <code class="mail">&lt;<a href="mailto:w@suika.fam.cx" rel="author"
      >w@suika.fam.cx</a>&gt;</code></dd>
</dl>

<p class="copyright" lang="en">&#xA9; <time>2007</time> <a
    href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>.
Permission is granted to copy, distribute and/or modify this document
under the terms of the <a rel="license"
href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>,
Version 1.2
or any later version published by the <a
href="http://www.fsf.org/">Free Software Foundation</a>;
with no Invariant Sections, no Front$B!>(BCover Texts, and no Back$B!>(BCover
Texts.  A copy of the license is
available at <code class="URI">&lt;<a
    href="http://www.gnu.org/copyleft/fdl.html"
    rel="license">http://www.gnu.org/copyleft/fdl.html</a>&gt;</code>.</p>
</div>

<div id="abstract" class="section">
<h2>Abstract</h2>

<div class="ed issue">...</div>

</div>

<div id="status" class="section">
<h2>Status of This Document</h2>

<p class=section-info><em>This section describes the status of this document
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 <a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a> 
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>

<p>Comments on this document are welcome and
may be sent to the <a href="#author">author</a>.</p>

<p>Translations of thie document might be available.
The English version of the document is the only
normative version.</p>
</div>

<div id="introduction" class="section">
<h2>Introduction</h2>

<p class=section-info>This section is <em>non-normative</em>.</p>

<p>Selectors 
<cite class="bibref normative">[<a href="#ref-SELECTORS">SELECTORS</a>]</cite>
are patterns that match against elements
in a tree structure and are used in Web technologies, including 
<a href="http://www.w3.org/TR/CSS21"><abbr title="Cascading Style Sheets">CSS</abbr></a>
<cite class="bibref informative">[<a href="#ref-CSS">CSS</a>]</cite>,
<a href="http://whatwg.org/html5"><abbr title="Hypertext Markup Language">HTML</abbr>5</a>
<cite class="bibref informative">[<a href="#ref-HTML5">HTML5</a>]</cite>,
<a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr title="XML Binding Language">XBL</abbr>2</a>
<cite class="bibref informative">[<a href="#ref-XBL2">XBL2</a>]</cite>, and 
<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 class="bibref informative">[<a href="#ref-SAPI">SAPI</a>]</cite>.</p>

<div class="issue ed">...</div>

<p><a href="http://dev.w3.org/cvsweb/csswg/cssom/Overview.html">The 
<abbr title="Cascading Style Sheets Object Model">CSSOM</abbr> 
specification</a> 
<cite class="bibref informative">[<a href="#ref-CSSOM">CSSOM</a>]</cite> 
is trying to define an algorithm to
<a href="http://dev.w3.org/cvsweb/~checkout~/csswg/cssom/Overview.html?rev=1.55&amp;content-type=text/html;%20charset=utf-8#serializing0">serialize
a group of selectors</a> for the purpose of <code>selectorText</code>
attribute.  However, the algorithm is incomplete
<time datetime=2007-09-25>at the time of the writing</time>.  
Note that current Web browser implementations
of the <code>selectorText</code> attribute are consistently broken
in not escaping unsafe identifiers.</p>

</div>

<div class="section" id="terminology">
<h2>Terminology</h2>

<p>The key words <q><em class="rfc2119">MUST</em></q>,
<q><em class="rfc2119">MUST NOT</em></q>,
<q><em class="rfc2119">SHOULD</em></q>,
<q><em class="rfc2119">SHOULD NOT</em></q>, and
<q><em class=rfc2119>MAY</em></q> in this
document are to be interpreted as described in 
<a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr> 
2119</a>
<cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>

<!-- Strictly speaking the paragraph below is not part of terminology. -->
<p>All examples and notes in this specification are non-normative,
as are all sections explicitly marked non-normative.  Everything
else in this specification is normative.</p>
</div>

<div class="section" id="serializing">
<h2>Serializing Groups of Selectors</h2>

<div class="issue ed">
<p><a href="http://suika.fam.cx/gate/cvs/*checkout*/markup/html/whatpm/Whatpm/CSS/SelectorsSerializer.pm">See the reference implementation</a>
for now.</p>
</div>

<p><dfn id=newline>Newline</dfn> is <code class=char>U+000A</code>
<code class=charname>LINE FEED</code> <span class=ed>or
U+000D U+000A or U+000A ??</span>.</p>

<!-- TODO: link terms to Selectors -->

<p>To <dfn id=algorithm-serialize-a-group-of-selectors>serialize a group of 
selectors</dfn> (<dfn id=var-gs><var>gs</var></dfn>):</p>
<ol>
<li>Let <dfn id=var-result><var>result</var></dfn> an empty string.</li>
<li>For each selector (<dfn id=var-selector><var>selector</var></dfn>) in 
<var>gs</var>:
  <ol>
  <li>If <var>selector</var> is <em>not</em> the first selector
  in the group of selectors, then append a <code class=char>U+002C</code>
  <code class=charname>COMMA</code> followed by a
  <a href="#newline">newline</a> to <var>result</var>.</li>
  <li>Append four <code class=char>U+0020</code>
  <code class=charname>SPACE</code> characters to <var>result</var>.</li>
  <li>Process each sequence of simple selectors or
  combinator in <var>selector</var> by following algorithm:
    <dl class=switch>
    <dt>If it is a sequence of simle selector 
    (<dfn id=var-sss><var>sss</var></dfn>)</dt>
      <dd class=ed>@@</dd>
    <dt>If it is a combinator (<dfn id=var-c><var>c</var></dfn>)</dt>
      <dd>
        <ol>
        <li>Append two <code class=char>U+0020</code>
        <code class=charname>SPACE</code> characters to <var>result</var>.</li>
        <li>
          <dl class=switch>
          <dt>If <var>c</var> is descendant combinator (white space)</dt>
            <dd>Append a <code class=char>U+0020</code>
            <code class=charname>SPACE</code> character to
            <var>result</var>.</dd>
          <dt>If <var>c</var> is child combinator
          (<code class=char>></code>)</dt>
            <dd>Append a <code class=char>U+003E</code>
            <code class=charname>GREATER-THAN SIGN</code> character to
            <var>result</var>.</dd>
          <dt>If <var>c</var> is adjacent sibling combinator
          (<code class=char>+</code>)</dt>
            <dd>Append a <code class=char>U+002B</code>
            <code class=charname>PLUS SIGN</code> character to
            <var>result</var>.</dd>
          <dt>If <var>c</var> is general sibling combinator
          (<code class=char>~</code>)</dt>
            <dd>Append a <code class=char>U+007E</code>
            <code class=charname>TILDE</code> character to
            <var>result</var>.</dd>
          </dl>
        </li>
        <li>Append a <code class=char>U+0020</code>
        <code class=charname>SPACE</code> character to
        <var>result</var>.</li>
        </ol>
      </dd>
    </dl>
  </ol>
</li>
<li>Then, <var>result</var> is the 
<abbr title="Selectors Serialization Format for Testing">SFFT</abbr>
representation of the group of selectors.</li>
</ol>

<p>To <dfn id=algorithm-serialize-a-simple-selector>serialize a simple 
selector</dfn> (<dfn><var id=var-ss>ss</var></dfn>):</p>
<dl class=switch>
<dt>If <var>ss</var> is a type or universal selector</dt>
  <dd><dl class=switch>
  <dt>If a namespace URI is specified (via namespace prefix, or
  by omitting namespace prefix where a default namespace is specified)</dt>
    <dd class="ed">@@</dd>
  <dt>If the null namespace is specified (by zero$B!>(Blength namespace
  prefix)</dt>
    <dd>Return a <code class=char>U+007C</code> <code class=charname>VERTICAL
    BAR</code> character, followed by either local name (if <var>ss</var>
    is a type selector) or a <code class=char>U+002A</code>
    <code class=charname>ASTERISK</code> character (if <var>ss</var>
    is a universal selector).</dd>
  <dt>If no namespace is specified (by namespace prefix <code>*</code>,
  or by omitting namespace prefix where no default namespace is specified)</dt>
    <dd>Return a <code class=char>U+002A</code> 
    <code class=charname>ASTERISK</code> character, followed by a
    <code class=char>U+007C</code> <code class=charname>VERTICAL BAR</code>
    character, followed by either local name (if <var>ss</var>
    is a type selector) or a <code class=char>U+002A</code>
    <code class=charname>ASTERISK</code> character (if <var>ss</var>
    is a universal selector).</dd>
  </dl></dd>
<dt class=ed>@@</dt>
</dl>

</div>

<div class="section" id="parsing">
<h2>Parsing 
<abbr title="Selectors Serialization Format for Testing">SFFT</abbr>
Groups of Selectors</h2>

<p>Since <a href="#serializing">the serializing algorithm</a> is 
so designed that it always output a valid 
<a href="http://www.w3.org/TR/css3-selectors/#grouping">group of
selectors</a>, no special parser for
<abbr title="Selectors Serialization Format for Testing">SFFT</abbr>
is necessary.  Any conforming 
<a href="http://www.w3.org/TR/css3-selectors/#grouping">group of
selectors</a> parser <em class=rfc2119>MAY</em> be used
to parse <abbr title="Selectors Serialization Format for Testing">SFFT</abbr> 
groups of selectors.</p>
</div>

<div class="section" id="examples">
<h2>Examples</h2>

<p class=section-info>This section is <em>non-normative</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.</a></p>

<div class="example figure block">
<div class="caption">...</div>

<pre><code>...</code></pre>
</div>

</div>

</div>

<div id="references" class="section reference">
<h2>References</h1>

<div id="normative-references" class="section normative reference">
<h3>Normative References</h3>

<dl>
<dt id="ref-KEYWORDS">KEYWORDS</dt>
  <dd><cite><a href="urn:ietf:rfc:2119">Key words for use in 
  <abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>,
  <abbr title="Internet Engineering Task Force">IETF</abbr> 
  <a href="urn:ietf:bcp:14"><abbr title="Best Current Practice">BCP</abbr> 
  14</a>, <abbr title="Request for Comments">RFC</abbr> 2119, 
  <time datetime=1997-03>March 1997</time>.
  This version of the specification is referenced</dd>
<dt id=ref-SELECTORS>SELECTORS</dt>
  <dd><a href="http://www.w3.org/TR/2005/WD-css3-selectors-20051215"><cite>Selectors</cite></a>,
  <abbr title="World Wide Web Consortium">W3C</abbr> Working Draft,
  <time datetime=2005-12-15>15 December 2005</time>.  Work in progress.  
  <a href="http://www.w3.org/TR/css3-selectors">The latest version</a>
  of the specification is referenced.</dd>
</dl>
</div>

<div id="informative-references" class="section informative reference">
<h3>Non-normative References</h3>

<dl>
<dt id=ref-CSS>CSS</dt>
  <dd><cite><a href="http://www.w3.org/TR/2007/CR-CSS21-20070719">Cascading
  Style Sheets Level 2 Revision 1 (<abbr>CSS</abbr> 2.1)
  Specification</a></cite>, 
  <abbr title="World Wide Web Consortium">W3C</abbr> Candidate
  Recommendation, <time datetime=2007-07-19>19 July 2007</time>.
  Work in progress.  The latest version of the specification is
  available at 
  <code class=URI>&lt;<a href="http://www.w3.org/TR/CSS21">http://www.w3.org/TR/CSS21</a>></code>.</dd>
<dt id=ref-CSSOM>CSSOM</dt>
  <dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/csswg/cssom/Overview.html?rev=1.55&amp;content-type=text/html;%20charset=utf-8">Cascading
  Style Sheets Object Model (<abbr>CSSOM</abbr>)</a></cite>,
  <abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,
  <time datetime=2007-06-18>18 June 2007</time>.  Work in progress.
  The latest Editor's Draft of the specification is available at
  <code class=URI>&lt;<a href="http://dev.w3.org/csswg/cssom/Overview.html">http://dev.w3.org/csswg/cssom/Overview.html</a>></code>.</dd>
<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>
<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,
  <time datetime=2007-08-29>29 August 2007</time>.  Work in progress.
  The latest Editor's Draft of the specification is available at
  <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>.
  The latest published version of the specification is available at
  <code class=URI>&lt;<a href="http://www.w3.org/TR/selectors-api/">http://www.w3.org/TR/selectors-api/</a>></code>.</dd>
<dt id=XBL2>XBL2</dt>
  <dd><cite><a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr>XBL</abbr>
  2.0</a></cite>, Mozilla.org, <time datetime=2007-03-15>15 Mar 2007</time>.
  Work in progress.  The latest
  <abbr title="World Wide Web Consortium">W3C</abbr>$B!>(Bpublished
  version of the specification is available at
  <code class=URI>&lt;<a href="http://www.w3.org/TR/xbl/">http://www.w3.org/TR/xbl/</a>></code>.</dd>
</dl>
</div>

</div>

</body>
</html>
1	<!DOCTYPE html>
2	<html lang="en" class="formal-specification status-work-in-progress">
3	<head>
4	<title>Selectors Serialization Format for Testing (SSFT) Specification</title>
5	<link rel="stylesheet" href="http://suika.fam.cx/www/style/html/spec">
6	<link rel="license" href="http://suika.fam.cx/c/gnu/fdl">
7	</head>
8	<body class="has-abstract">
9
10	<div class="header">
11	<h1>Selectors Serialization Format for Testing (<abbr>SSFT</abbr>)
12	Specification</h1>
13	<h2>Working Draft <time datetime=2007-10-02>2 October 2007</time></h2>
14
15	<dl class="versions-uri">
16	<dt>This Version</dt>
17	<dd><code class="URI"><<a href="http://suika.fam.cx/www/markup/selectors/ssft/ssft"
18	>http://suika.fam.cx/www/markup/selectors/ssft/ssft</a>></code></dd>
19	<dt>Latest Version</dt>
20	<dd><code class="URI"><<a href="http://suika.fam.cx/www/markup/selectors/ssft/ssft"
21	>http://suika.fam.cx/www/markup/selectors/ssft/ssft</a>></code></dd>
22	<!--
23	<dt>Latest Working Draft</dt>
24	-->
25	<!-- <dt>Previous Version</dt> -->
26	<dt>Version History</dt>
27	<dd><code class=URI><<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>></code></dd>
28	</dl>
29	<dl class="authors" id="author">
30	<dt>Author</dt>
31	<dd><a href="http://suika.fam.cx/~wakaba/who?" rel="author"
32	lang=ja>Wakaba</a>
33	<code class="mail"><<a href="mailto:w@suika.fam.cx" rel="author"
34	>w@suika.fam.cx</a>></code></dd>
35	</dl>
36
37	<p class="copyright" lang="en">© <time>2007</time> <a
38	href="http://suika.fam.cx/~wakaba/who?" rel="author">Wakaba</a>.
39	Permission is granted to copy, distribute and/or modify this document
40	under the terms of the <a rel="license"
41	href="http://www.gnu.org/copyleft/fdl.html">GNU Free Documentation License</a>,
42	Version 1.2
43	or any later version published by the <a
44	href="http://www.fsf.org/">Free Software Foundation</a>;
45	with no Invariant Sections, no Front$B!>(BCover Texts, and no Back$B!>(BCover
46	Texts. A copy of the license is
47	available at <code class="URI"><<a
48	href="http://www.gnu.org/copyleft/fdl.html"
49	rel="license">http://www.gnu.org/copyleft/fdl.html</a>></code>.</p>
50	</div>
51
52	<div id="abstract" class="section">
53	<h2>Abstract</h2>
54
55	<div class="ed issue">...</div>
56
57	</div>
58
59	<div id="status" class="section">
60	<h2>Status of This Document</h2>
61
62	<p class=section-info><em>This section describes the status of this document
63	at the time of its publication. Other documents
64	might supersede this document.</em></p>
65
66	<p>This document is a working draft, produced as part
67	of the <a href="http://suika.fam.cx/www/manakai-core/doc/web/">manakai</a>
68	project. It might be updated, replaced, or obsoleted by
69	other documents at any time. It is inappropriate to
70	cite this document as other than <q>work in progress</q>.</p>
71
72	<p>Comments on this document are welcome and
73	may be sent to the <a href="#author">author</a>.</p>
74
75	<p>Translations of thie document might be available.
76	The English version of the document is the only
77	normative version.</p>
78	</div>
79
80	<div id="introduction" class="section">
81	<h2>Introduction</h2>
82
83	<p class=section-info>This section is <em>non-normative</em>.</p>
84
85	<p>Selectors
86	<cite class="bibref normative">[<a href="#ref-SELECTORS">SELECTORS</a>]</cite>
87	are patterns that match against elements
88	in a tree structure and are used in Web technologies, including
89	<a href="http://www.w3.org/TR/CSS21"><abbr title="Cascading Style Sheets">CSS</abbr></a>
90	<cite class="bibref informative">[<a href="#ref-CSS">CSS</a>]</cite>,
91	<a href="http://whatwg.org/html5"><abbr title="Hypertext Markup Language">HTML</abbr>5</a>
92	<cite class="bibref informative">[<a href="#ref-HTML5">HTML5</a>]</cite>,
93	<a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr title="XML Binding Language">XBL</abbr>2</a>
94	<cite class="bibref informative">[<a href="#ref-XBL2">XBL2</a>]</cite>, and
95	<a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/selectors-api/Overview.html?rev=1.28&content-type=text/html;%20charset=utf-8">Selectors
96	<abbr>API</abbr></a>
97	<cite class="bibref informative">[<a href="#ref-SAPI">SAPI</a>]</cite>.</p>
98
99	<div class="issue ed">...</div>
100
101	<p><a href="http://dev.w3.org/cvsweb/csswg/cssom/Overview.html">The
102	<abbr title="Cascading Style Sheets Object Model">CSSOM</abbr>
103	specification</a>
104	<cite class="bibref informative">[<a href="#ref-CSSOM">CSSOM</a>]</cite>
105	is trying to define an algorithm to
106	<a href="http://dev.w3.org/cvsweb/~checkout~/csswg/cssom/Overview.html?rev=1.55&content-type=text/html;%20charset=utf-8#serializing0">serialize
107	a group of selectors</a> for the purpose of <code>selectorText</code>
108	attribute. However, the algorithm is incomplete
109	<time datetime=2007-09-25>at the time of the writing</time>.
110	Note that current Web browser implementations
111	of the <code>selectorText</code> attribute are consistently broken
112	in not escaping unsafe identifiers.</p>
113
114	</div>
115
116	<div class="section" id="terminology">
117	<h2>Terminology</h2>
118
119	<p>The key words <q><em class="rfc2119">MUST</em></q>,
120	<q><em class="rfc2119">MUST NOT</em></q>,
121	<q><em class="rfc2119">SHOULD</em></q>,
122	<q><em class="rfc2119">SHOULD NOT</em></q>, and
123	<q><em class=rfc2119>MAY</em></q> in this
124	document are to be interpreted as described in
125	<a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>
126	2119</a>
127	<cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
128
129	<!-- Strictly speaking the paragraph below is not part of terminology. -->
130	<p>All examples and notes in this specification are non-normative,
131	as are all sections explicitly marked non-normative. Everything
132	else in this specification is normative.</p>
133	</div>
134
135	<div class="section" id="serializing">
136	<h2>Serializing Groups of Selectors</h2>
137
138	<div class="issue ed">
139	<p><a href="http://suika.fam.cx/gate/cvs/checkout/markup/html/whatpm/Whatpm/CSS/SelectorsSerializer.pm">See the reference implementation</a>
140	for now.</p>
141	</div>
142
143	<p><dfn id=newline>Newline</dfn> is <code class=char>U+000A</code>
144	<code class=charname>LINE FEED</code> <span class=ed>or
145	U+000D U+000A or U+000A ??</span>.</p>
146
147	<!-- TODO: link terms to Selectors -->
148
149	<p>To <dfn id=algorithm-serialize-a-group-of-selectors>serialize a group of
150	selectors</dfn> (<dfn id=var-gs><var>gs</var></dfn>):</p>
151	<ol>
152	<li>Let <dfn id=var-result><var>result</var></dfn> an empty string.</li>
153	<li>For each selector (<dfn id=var-selector><var>selector</var></dfn>) in
154	<var>gs</var>:
155	<ol>
156	<li>If <var>selector</var> is <em>not</em> the first selector
157	in the group of selectors, then append a <code class=char>U+002C</code>
158	<code class=charname>COMMA</code> followed by a
159	<a href="#newline">newline</a> to <var>result</var>.</li>
160	<li>Append four <code class=char>U+0020</code>
161	<code class=charname>SPACE</code> characters to <var>result</var>.</li>
162	<li>Process each sequence of simple selectors or
163	combinator in <var>selector</var> by following algorithm:
164	<dl class=switch>
165	<dt>If it is a sequence of simle selector
166	(<dfn id=var-sss><var>sss</var></dfn>)</dt>
167	<dd class=ed>@@</dd>
168	<dt>If it is a combinator (<dfn id=var-c><var>c</var></dfn>)</dt>
169	<dd>
170	<ol>
171	<li>Append two <code class=char>U+0020</code>
172	<code class=charname>SPACE</code> characters to <var>result</var>.</li>
173	<li>
174	<dl class=switch>
175	<dt>If <var>c</var> is descendant combinator (white space)</dt>
176	<dd>Append a <code class=char>U+0020</code>
177	<code class=charname>SPACE</code> character to
178	<var>result</var>.</dd>
179	<dt>If <var>c</var> is child combinator
180	(<code class=char>></code>)</dt>
181	<dd>Append a <code class=char>U+003E</code>
182	<code class=charname>GREATER-THAN SIGN</code> character to
183	<var>result</var>.</dd>
184	<dt>If <var>c</var> is adjacent sibling combinator
185	(<code class=char>+</code>)</dt>
186	<dd>Append a <code class=char>U+002B</code>
187	<code class=charname>PLUS SIGN</code> character to
188	<var>result</var>.</dd>
189	<dt>If <var>c</var> is general sibling combinator
190	(<code class=char>~</code>)</dt>
191	<dd>Append a <code class=char>U+007E</code>
192	<code class=charname>TILDE</code> character to
193	<var>result</var>.</dd>
194	</dl>
195	</li>
196	<li>Append a <code class=char>U+0020</code>
197	<code class=charname>SPACE</code> character to
198	<var>result</var>.</li>
199	</ol>
200	</dd>
201	</dl>
202	</ol>
203	</li>
204	<li>Then, <var>result</var> is the
205	<abbr title="Selectors Serialization Format for Testing">SFFT</abbr>
206	representation of the group of selectors.</li>
207	</ol>
208
209	<p>To <dfn id=algorithm-serialize-a-simple-selector>serialize a simple
210	selector</dfn> (<dfn><var id=var-ss>ss</var></dfn>):</p>
211	<dl class=switch>
212	<dt>If <var>ss</var> is a type or universal selector</dt>
213	<dd><dl class=switch>
214	<dt>If a namespace URI is specified (via namespace prefix, or
215	by omitting namespace prefix where a default namespace is specified)</dt>
216	<dd class="ed">@@</dd>
217	<dt>If the null namespace is specified (by zero$B!>(Blength namespace
218	prefix)</dt>
219	<dd>Return a <code class=char>U+007C</code> <code class=charname>VERTICAL
220	BAR</code> character, followed by either local name (if <var>ss</var>
221	is a type selector) or a <code class=char>U+002A</code>
222	<code class=charname>ASTERISK</code> character (if <var>ss</var>
223	is a universal selector).</dd>
224	<dt>If no namespace is specified (by namespace prefix <code>*</code>,
225	or by omitting namespace prefix where no default namespace is specified)</dt>
226	<dd>Return a <code class=char>U+002A</code>
227	<code class=charname>ASTERISK</code> character, followed by a
228	<code class=char>U+007C</code> <code class=charname>VERTICAL BAR</code>
229	character, followed by either local name (if <var>ss</var>
230	is a type selector) or a <code class=char>U+002A</code>
231	<code class=charname>ASTERISK</code> character (if <var>ss</var>
232	is a universal selector).</dd>
233	</dl></dd>
234	<dt class=ed>@@</dt>
235	</dl>
236
237	</div>
238
239	<div class="section" id="parsing">
240	<h2>Parsing
241	<abbr title="Selectors Serialization Format for Testing">SFFT</abbr>
242	Groups of Selectors</h2>
243
244	<p>Since <a href="#serializing">the serializing algorithm</a> is
245	so designed that it always output a valid
246	<a href="http://www.w3.org/TR/css3-selectors/#grouping">group of
247	selectors</a>, no special parser for
248	<abbr title="Selectors Serialization Format for Testing">SFFT</abbr>
249	is necessary. Any conforming
250	<a href="http://www.w3.org/TR/css3-selectors/#grouping">group of
251	selectors</a> parser <em class=rfc2119>MAY</em> be used
252	to parse <abbr title="Selectors Serialization Format for Testing">SFFT</abbr>
253	groups of selectors.</p>
254	</div>
255
256	<div class="section" id="examples">
257	<h2>Examples</h2>
258
259	<p class=section-info>This section is <em>non-normative</em>.</p>
260
261	<div class="ed issue">
262	<p><a href="http://suika.fam.cx/gate/2007/css/parser-interface">Try demo</a>,
263	by choosing <q>Selectors</q> radio button.</a></p>
264
265	<div class="example figure block">
266	<div class="caption">...</div>
267
268	<pre><code>...</code></pre>
269	</div>
270
271	</div>
272
273	</div>
274
275	<div id="references" class="section reference">
276	<h2>References</h1>
277
278	<div id="normative-references" class="section normative reference">
279	<h3>Normative References</h3>
280
281	<dl>
282	<dt id="ref-KEYWORDS">KEYWORDS</dt>
283	<dd><cite><a href="urn:ietf:rfc:2119">Key words for use in
284	<abbr>RFCs</abbr> to Indicate Requirement Levels</a></cite>,
285	<abbr title="Internet Engineering Task Force">IETF</abbr>
286	<a href="urn:ietf:bcp:14"><abbr title="Best Current Practice">BCP</abbr>
287	14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,
288	<time datetime=1997-03>March 1997</time>.
289	This version of the specification is referenced</dd>
290	<dt id=ref-SELECTORS>SELECTORS</dt>
291	<dd><a href="http://www.w3.org/TR/2005/WD-css3-selectors-20051215"><cite>Selectors</cite></a>,
292	<abbr title="World Wide Web Consortium">W3C</abbr> Working Draft,
293	<time datetime=2005-12-15>15 December 2005</time>. Work in progress.
294	<a href="http://www.w3.org/TR/css3-selectors">The latest version</a>
295	of the specification is referenced.</dd>
296	</dl>
297	</div>
298
299	<div id="informative-references" class="section informative reference">
300	<h3>Non-normative References</h3>
301
302	<dl>
303	<dt id=ref-CSS>CSS</dt>
304	<dd><cite><a href="http://www.w3.org/TR/2007/CR-CSS21-20070719">Cascading
305	Style Sheets Level 2 Revision 1 (<abbr>CSS</abbr> 2.1)
306	Specification</a></cite>,
307	<abbr title="World Wide Web Consortium">W3C</abbr> Candidate
308	Recommendation, <time datetime=2007-07-19>19 July 2007</time>.
309	Work in progress. The latest version of the specification is
310	available at
311	<code class=URI><<a href="http://www.w3.org/TR/CSS21">http://www.w3.org/TR/CSS21</a>></code>.</dd>
312	<dt id=ref-CSSOM>CSSOM</dt>
313	<dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/csswg/cssom/Overview.html?rev=1.55&content-type=text/html;%20charset=utf-8">Cascading
314	Style Sheets Object Model (<abbr>CSSOM</abbr>)</a></cite>,
315	<abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,
316	<time datetime=2007-06-18>18 June 2007</time>. Work in progress.
317	The latest Editor's Draft of the specification is available at
318	<code class=URI><<a href="http://dev.w3.org/csswg/cssom/Overview.html">http://dev.w3.org/csswg/cssom/Overview.html</a>></code>.</dd>
319	<dt id=ref-HTML5>HTML5</dt>
320	<dd><cite><a href="http://whatwg.org/html5"><abbr>HTML</abbr> 5</a></cite>,
321	<abbr title="Web Hypertext Application Technology Working Group">WHATWG</abbr>
322	Working Draft. Work in progress.</dd>
323	<dt id=ref-SAPI>SAPI</dt>
324	<dd><cite><a href="http://dev.w3.org/cvsweb/~checkout~/2006/webapi/selectors-api/Overview.html?rev=1.28&content-type=text/html;%20charset=utf-8">Selectors <abbr>API</abbr></a></cite>,
325	<abbr title="World Wide Web Consortium">W3C</abbr> Editor's Draft,
326	<time datetime=2007-08-29>29 August 2007</time>. Work in progress.
327	The latest Editor's Draft of the specification is available at
328	<code class=URI><<a href="http://dev.w3.org/2006/webapi/selectors-api/Overview.html">http://dev.w3.org/2006/webapi/selectors-api/Overview.html</a>></code>.
329	The latest published version of the specification is available at
330	<code class=URI><<a href="http://www.w3.org/TR/selectors-api/">http://www.w3.org/TR/selectors-api/</a>></code>.</dd>
331	<dt id=XBL2>XBL2</dt>
332	<dd><cite><a href="http://www.mozilla.org/projects/xbl/xbl2.html"><abbr>XBL</abbr>
333	2.0</a></cite>, Mozilla.org, <time datetime=2007-03-15>15 Mar 2007</time>.
334	Work in progress. The latest
335	<abbr title="World Wide Web Consortium">W3C</abbr>$B!>(Bpublished
336	version of the specification is available at
337	<code class=URI><<a href="http://www.w3.org/TR/xbl/">http://www.w3.org/TR/xbl/</a>></code>.</dd>
338	</dl>
339	</div>
340
341	</div>
342
343	</body>
344	</html>