selectors/ssft/ssft.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	wakaba	1.1	<!DOCTYPE html>
2			<html lang="en" class="formal-specification status-work-in-progress">
3			<head>
4	wakaba	1.2	<title>Selectors Serialization Format for Testing (SSFT) Specification</title>
5	wakaba	1.1	<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	wakaba	1.2	<h1>Selectors Serialization Format for Testing (<abbr>SSFT</abbr>)
12			Specification</h1>
13	wakaba	1.6	<h2>Working Draft <time datetime=2007-10-02>2 October 2007</time></h2>
14	wakaba	1.1
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	wakaba	1.5	<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	wakaba	1.1	</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	wakaba	1.5	<p class="copyright" lang="en">© <time>2007</time> <a
38	wakaba	1.1	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	wakaba	1.5	<p class=section-info><em>This section describes the status of this document
63	wakaba	1.1	at the time of its publication. Other documents
64			might supersede this document.</em></p>
65
66	wakaba	1.5	<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	wakaba	1.1	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	wakaba	1.5	<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	wakaba	1.4
99	wakaba	1.1	<div class="issue ed">...</div>
100
101	wakaba	1.4	<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	wakaba	1.5	<cite class="bibref informative">[<a href="#ref-CSSOM">CSSOM</a>]</cite>
105	wakaba	1.4	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	wakaba	1.5	<time datetime=2007-09-25>at the time of the writing</time>.
110			Note that current Web browser implementations
111	wakaba	1.4	of the <code>selectorText</code> attribute are consistently broken
112			in not escaping unsafe identifiers.</p>
113
114	wakaba	1.1	</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	wakaba	1.5	<a href="urn:ietf:rfc:2119"><abbr title="Request for Comments">RFC</abbr>
126			2119</a>
127	wakaba	1.1	<cite class="bibref normative">[<a href="#ref-KEYWORDS">KEYWORDS</a>]</cite>.</p>
128	wakaba	1.5
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	wakaba	1.1	</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	wakaba	1.3
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	wakaba	1.4	<!-- TODO: link terms to Selectors -->
148
149	wakaba	1.6	<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	wakaba	1.3	<ol>
152	wakaba	1.6	<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	wakaba	1.3	<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	wakaba	1.6	<dt>If it is a sequence of simle selector
166			(<dfn id=var-sss><var>sss</var></dfn>)</dt>
167	wakaba	1.3	<dd class=ed>@@</dd>
168	wakaba	1.6	<dt>If it is a combinator (<dfn id=var-c><var>c</var></dfn>)</dt>
169	wakaba	1.3	<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	wakaba	1.5	<dd>Append a <code class=char>U+002B</code>
187			<code class=charname>PLUS SIGN</code> character to
188	wakaba	1.3	<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	wakaba	1.6
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	wakaba	1.1
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	wakaba	1.4	selectors</a>, no special parser for
248			<abbr title="Selectors Serialization Format for Testing">SFFT</abbr>
249	wakaba	1.1	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	wakaba	1.5	<p class=section-info>This section is <em>non-normative</em>.</p>
260	wakaba	1.1
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	wakaba	1.4	<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	wakaba	1.5	14</a>, <abbr title="Request for Comments">RFC</abbr> 2119,
288			<time datetime=1997-03>March 1997</time>.
289	wakaba	1.4	This version of the specification is referenced</dd>
290	wakaba	1.1	<dt id=ref-SELECTORS>SELECTORS</dt>
291	wakaba	1.2	<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	wakaba	1.5	<time datetime=2005-12-15>15 December 2005</time>. Work in progress.
294	wakaba	1.2	<a href="http://www.w3.org/TR/css3-selectors">The latest version</a>
295			of the specification is referenced.</dd>
296	wakaba	1.1	</dl>
297			</div>
298
299			<div id="informative-references" class="section informative reference">
300	wakaba	1.5	<h3>Non-normative References</h3>
301	wakaba	1.1
302			<dl>
303	wakaba	1.5	<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	wakaba	1.4	<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	wakaba	1.5	<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	wakaba	1.1	</dl>
339			</div>
340
341			</div>
342
343			</body>
344			</html>