Whatpm/CSS/selectors-object.en.html

<!DOCTYPE HTML>
<html lang=en>
<head>
<title>Whatpm's Selectors Object</title>
<link rel=stylesheet href="http://suika.fam.cx/www/style/html/xhtml">
<link rel=author title=Wakaba href="http://suika.fam.cx/~wakaba/who?" lang=ja>
<link rel=license href="#license">
<style>
p.synopsis {
  margin-left: 4em;
  margin-right: 2em;
  margin-top: 1em;
  margin-bottom: 1em;
  padding-left: 3em;
  padding-right: 1em;
  text-indent: -2em;
  background-color: #ffeeff;
  color: black;
  text-align: left;
}
.synopsis > code {
  color: inherit;
}
</style>
</head>
<body>
<h1>Selectors Object</h1>

<div class=section id=structure>
<h2>Structure of Selectors Object</h2>

<p>A <dfn id=group-of-selectors-object>group of selectors object</dfn> is 
represented as a reference to a Perl array, which contains zero or more 
<a href="#selector-object">selector object</a>.</p>

<p class=synopsis><code>$group_of_selectors = [$selector1, $selector2,
<var>...</var>, $selectors<var>n</var>];</code></p>

<p>A <dfn id=selector-object>selector object</dfn> is represented as a 
reference to a Perl array, which contains zero or more sequence of a 
<a href="#combinator-value">combinator value</a> followed by a 
<a href="#sss-object">sequence of simple selectors object</a>.
The first <a href="#combinator-value">combinator value</a>, if any, is always 
(and <em class=rfc2119>MUST</em> be) 
<a href="SelectorsParser.html#item_descendant_combinator"><code>DESCENDANT_COMBINATOR</code></a>.</p>

<p class=synopsis><code>$selector = [$combinator1, $sss1, 
$combinator2, $sss2, <var>...</var>, 
$combinator<var>n</var>, $sss<var>n</var>];</code></p>

<p>A <dfn id=combinator-value>combinator value</dfn> is one of 
<a href="SelectorsParser.html#combinator_types">combinator types</a>.</p>

<p>A <dfn id=sss-object>sequence of simple selectors pbject</dfn> is
represented as a reference to a Perl array, which contains zero or
more <a href="#simple-selector-object">simple selector object</a>.</p>

<p class=synopsis><code>$sss = [$ss1, $ss2, <var>...</var>, 
$ss<var>n</var>];</code></p>

<p>A <dfn id=simple-selector-object>simple selector object</dfn> is one of 
following objects:</p>
<dl>
<dt><dfn id=namespace-selector-object>Namespace selector object</dfn></dt>
  <dd>
    <p>Represented as a reference to a Perl array, which contains a value of
    <a href="SelectorsParser.html#item_namespace_selector"><code>NAMESPACE_SELECTOR</code></a>,
    followed by a scalar value.  The scalar value is either 
    <code>undef</code>, which represents the null namespace (encoded as an
    empty namespace prefix in Selectors), or a non$B!>(Bempty string, which
    represents the namespace URI of an element.</p>

    <p class=synopsis><code>$selector = [NAMESPACE_SELECTOR, undef]; <code class=comment>## null namespace</code></code></p>
    <p class=synopsis><code>$selector = [NAMESPACE_SELECTOR, $nsuri]; <code class=comment>## non-null namespace</code></code></p>
  </dd>
</dl>

<p class=ed>@@
</div>

<div class=section id=error>
<h2>Error Handling Rule</h2>

<p class=ed>@@
</div>

<div class=section id=see-also>
<h2>See Also</h2>

<ul>
<li><a href="SelectorsParser.html"><code>Whatpm::CSS::SelectorsParser</code>
documentation</a></li>
</ul>
</div>

<div class=section id=author>
<h2>Author</h2>

<p><a href="http://suika.fam.cx/~wakaba/who?" rel=author>Wakaba</a>.</p>
</div>

<div class=section id=license>
<h2>License</h2>

<p>Copyright <time>2007</time> 
<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">w@suika.fam.cx</a>></code></p>

<p>This library is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.</p>
</div>

</body>
</html>
1	<!DOCTYPE HTML>
2	<html lang=en>
3	<head>
4	<title>Whatpm's Selectors Object</title>
5	<link rel=stylesheet href="http://suika.fam.cx/www/style/html/xhtml">
6	<link rel=author title=Wakaba href="http://suika.fam.cx/~wakaba/who?" lang=ja>
7	<link rel=license href="#license">
8	<style>
9	p.synopsis {
10	margin-left: 4em;
11	margin-right: 2em;
12	margin-top: 1em;
13	margin-bottom: 1em;
14	padding-left: 3em;
15	padding-right: 1em;
16	text-indent: -2em;
17	background-color: #ffeeff;
18	color: black;
19	text-align: left;
20	}
21	.synopsis > code {
22	color: inherit;
23	}
24	</style>
25	</head>
26	<body>
27	<h1>Selectors Object</h1>
28
29	<div class=section id=structure>
30	<h2>Structure of Selectors Object</h2>
31
32	<p>A <dfn id=group-of-selectors-object>group of selectors object</dfn> is
33	represented as a reference to a Perl array, which contains zero or more
34	<a href="#selector-object">selector object</a>.</p>
35
36	<p class=synopsis><code>$group_of_selectors = [$selector1, $selector2,
37	<var>...</var>, $selectors<var>n</var>];</code></p>
38
39	<p>A <dfn id=selector-object>selector object</dfn> is represented as a
40	reference to a Perl array, which contains zero or more sequence of a
41	<a href="#combinator-value">combinator value</a> followed by a
42	<a href="#sss-object">sequence of simple selectors object</a>.
43	The first <a href="#combinator-value">combinator value</a>, if any, is always
44	(and <em class=rfc2119>MUST</em> be)
45	<a href="SelectorsParser.html#item_descendant_combinator"><code>DESCENDANT_COMBINATOR</code></a>.</p>
46
47	<p class=synopsis><code>$selector = [$combinator1, $sss1,
48	$combinator2, $sss2, <var>...</var>,
49	$combinator<var>n</var>, $sss<var>n</var>];</code></p>
50
51	<p>A <dfn id=combinator-value>combinator value</dfn> is one of
52	<a href="SelectorsParser.html#combinator_types">combinator types</a>.</p>
53
54	<p>A <dfn id=sss-object>sequence of simple selectors pbject</dfn> is
55	represented as a reference to a Perl array, which contains zero or
56	more <a href="#simple-selector-object">simple selector object</a>.</p>
57
58	<p class=synopsis><code>$sss = [$ss1, $ss2, <var>...</var>,
59	$ss<var>n</var>];</code></p>
60
61	<p>A <dfn id=simple-selector-object>simple selector object</dfn> is one of
62	following objects:</p>
63	<dl>
64	<dt><dfn id=namespace-selector-object>Namespace selector object</dfn></dt>
65	<dd>
66	<p>Represented as a reference to a Perl array, which contains a value of
67	<a href="SelectorsParser.html#item_namespace_selector"><code>NAMESPACE_SELECTOR</code></a>,
68	followed by a scalar value. The scalar value is either
69	<code>undef</code>, which represents the null namespace (encoded as an
70	empty namespace prefix in Selectors), or a non$B!>(Bempty string, which
71	represents the namespace URI of an element.</p>
72
73	<p class=synopsis><code>$selector = [NAMESPACE_SELECTOR, undef]; <code class=comment>## null namespace</code></code></p>
74	<p class=synopsis><code>$selector = [NAMESPACE_SELECTOR, $nsuri]; <code class=comment>## non-null namespace</code></code></p>
75	</dd>
76	</dl>
77
78	<p class=ed>@@
79	</div>
80
81	<div class=section id=error>
82	<h2>Error Handling Rule</h2>
83
84	<p class=ed>@@
85	</div>
86
87	<div class=section id=see-also>
88	<h2>See Also</h2>
89
90	<ul>
91	<li><a href="SelectorsParser.html"><code>Whatpm::CSS::SelectorsParser</code>
92	documentation</a></li>
93	</ul>
94	</div>
95
96	<div class=section id=author>
97	<h2>Author</h2>
98
99	<p><a href="http://suika.fam.cx/~wakaba/who?" rel=author>Wakaba</a>.</p>
100	</div>
101
102	<div class=section id=license>
103	<h2>License</h2>
104
105	<p>Copyright <time>2007</time>
106	<a href="http://suika.fam.cx/~wakaba/who?" rel=author lang=ja>Wakaba</a>
107	<code class=mail><<a href="mailto:w@suika.fam.cx">w@suika.fam.cx</a>></code></p>
108
109	<p>This library is free software; you can redistribute it
110	and/or modify it under the same terms as Perl itself.</p>
111	</div>
112
113	</body>
114	</html>