W3C home > Mailing lists > Public > public-css-commits@w3.org > July 2011

csswg/selectors4 Overview.html,1.22,1.23 Overview.src.html,1.24,1.25

From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 12 Jul 2011 18:17:10 +0000
To: public-css-commits@w3.org
Message-Id: <E1QghWA-0006HY-Au@lionel-hutz.w3.org>
Update of /sources/public/csswg/selectors4
In directory hutz:/tmp/cvs-serv24131

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Reshuffle some sections, add :scope

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/selectors4/Overview.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -d -r1.22 -r1.23
--- Overview.html	7 Jul 2011 19:17:44 -0000	1.22
+++ Overview.html	12 Jul 2011 18:17:08 -0000	1.23
@@ -15,13 +15,13 @@
 
    <h1 id=title>Selectors Level 4</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 7 July 2011</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 12 July 2011</h2>
 
    <dl>
     <dt>This version:
 
-    <dd> <!-- <a href="http://www.w3.org/TR/2011/ED-selectors4-20110707/">
-             http://www.w3.org/TR/2011/WD-selectors4-20110707</a> -->
[...1788 lines suppressed...]
+
+   <dd>Tim Bray; et al. <a
+    href="http://www.w3.org/TR/2009/REC-xml-names-20091208/"><cite>Namespaces
+    in XML 1.0 (Third Edition).</cite></a> 8 December 2009. W3C
+    Recommendation. URL: <a
+    href="http://www.w3.org/TR/2009/REC-xml-names-20091208/">http://www.w3.org/TR/2009/REC-xml-names-20091208/</a>
+    </dd>
+   <!---->
+
+   <dt id=XML10>[XML10]
+
+   <dd>C. M. Sperberg-McQueen; et al. <a
+    href="http://www.w3.org/TR/2008/REC-xml-20081126/"><cite>Extensible
+    Markup Language (XML) 1.0 (Fifth Edition).</cite></a> 26 November 2008.
+    W3C Recommendation. URL: <a
+    href="http://www.w3.org/TR/2008/REC-xml-20081126/">http://www.w3.org/TR/2008/REC-xml-20081126/</a>
+    </dd>
+   <!---->
+  </dl>
+  <!--end-informative-->

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/selectors4/Overview.src.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -d -r1.24 -r1.25
--- Overview.src.html	7 Jul 2011 19:17:44 -0000	1.24
+++ Overview.src.html	12 Jul 2011 18:17:08 -0000	1.25
@@ -455,7 +455,7 @@
   <a href="#invalid">invalid selector</a>.</p>
 
 <h3 id=subject>
-Subject of a Selector</h3>
+Determining the Subject of a Selector</h3>
 
   <p>The elements of a document tree that are represented by a selector
   are the <dfn>subjects</dfn> of the selector.
@@ -485,6 +485,30 @@
     subjects of the selectors are not.
   </div>
 
+<h3 id=pseudo-classes>
+Pseudo-classes</h3>
+
+  <p>The pseudo-class concept is introduced to permit selection based on
+  information that lies outside of the document tree or that cannot be
+  expressed using the other simple selectors.</p>
+
+  <p>A pseudo-class always consists of a &quot;colon&quot;
+  (<code>:</code>) followed by the name of the pseudo-class and, for
+  functional pseudo-classes, by a value between parentheses.
+  White space is optionally allowed between the parentheses and the
+  argument, but not between the pseudo-class name and the parentheses.</p>
+
+  <p>Pseudo-classes are allowed in all compound selectors
+  contained in a selector. Pseudo-classes are allowed anywhere in a
+  compound selector after the leading type selector or
+  (possibly omitted) universal selector. Pseudo-class names are
+  case-insensitive. Some pseudo-classes are mutually exclusive (such
+  that a compound selector containing them, while valid, will never
+  match anything), while others can apply simultaneously to the same
+  element. Pseudo-classes may be dynamic, in the sense that an element
+  can acquire or lose a pseudo-class while a user interacts with the
+  document.</p>
+
 <h3 id=case-sensitive>
 Characters and case sensitivity</h3>
 
@@ -582,9 +606,9 @@
 <h3 id=matches>
 The Matches-Any Pseudo-class: '':matches()''</h3>
 
-  <p>The matches pseudo-class, <code>:matches(<var>X</var>)</code>,
-  is a functional notation taking a <a href="#grouping">selector group</a>
-  as an argument. It represents an element that is represented by its argument.
+  <p>The matches-any pseudo-class, <code>:matches(<var>X</var>)</code>,
+  is a functional notation taking a <a href="#grouping">selector list</a>
+  as its argument. It represents an element that is represented by its argument.
 
   <p>In Selectors Level 4, only <a href="#compound">compound selectors</a>
   are allowed within <code>:matches()</code>:
@@ -593,7 +617,7 @@
   <code>:not()</code>: <code>:matches(:matches(...))</code> and
   <code>:not(:matches(...))</code> are invalid.</p>
 
-  <p>Pseudo-elements cannot be represented by the matches pseudo-class;
+  <p>Pseudo-elements cannot be represented by the matches-any pseudo-class;
   they are not valid within <code>:matches()</code>.
 
   <p>Default namespace declarations do not affect the subject of any selector
@@ -616,7 +640,7 @@
 The Negation Pseudo-class: '':not()''</h3>
 
   <p>The negation pseudo-class, <code>:not(<var>X</var>)</code>, is a
-  functional notation taking a <a href="#grouping">selector group</a>
+  functional notation taking a <a href="#grouping">selector list</a>
   as an argument. It represents an element that is not represented
   by its argument.
 
@@ -1173,30 +1197,6 @@
   selector. Such a situation could be reached using mixtures of xml:id,
   DOM3 Core, XML DTDs, and namespace-specific knowledge.</p>
 
-<h2 id=pseudo-classes>
-Pseudo-classes Syntax and Overview</h2>
-
-  <p>The pseudo-class concept is introduced to permit selection based on
-  information that lies outside of the document tree or that cannot be
-  expressed using the other simple selectors.</p>
-
-  <p>A pseudo-class always consists of a &quot;colon&quot;
-  (<code>:</code>) followed by the name of the pseudo-class and, for
-  functional pseudo-classes, by a value between parentheses.
-  White space is optionally allowed between the parentheses and the
-  value, but not between the pseudo-class name and the parentheses.</p>
-
-  <p>Pseudo-classes are allowed in all compound selectors
-  contained in a selector. Pseudo-classes are allowed anywhere in
-  compound selector after the leading type selector or
-  (possibly omitted) universal selector. Pseudo-class names are
-  case-insensitive. Some pseudo-classes are mutually exclusive, while
-  others can be applied simultaneously to the same
-  element. Pseudo-classes may be dynamic, in the sense that an element
-  may acquire or lose a pseudo-class while a user interacts with the
-  document.</p>
-
-
 <h2 id=dynamic-pseudos>
 Dynamic pseudo-classes</h2>
 
@@ -1321,6 +1321,18 @@
     <pre>:not(:current(0)) { text-decoration-style: dashed; }</pre>
   </div>
 
+<h3 id=scope-pseudo>
+The scope pseudo-class :scope</h3>
+
+  <p>Sometimes the host language applies selectors within a limited scope within
+  the document. For example, the <i>contextual reference node</i> in a
+  <code>querySelector</code> call [[SELECT-API2]] or the parent element of a
+  scoped HTML <code>&lt;style&gt;</code> element [[HTML5]] defines a scope.
+  The <code>:scope</code> pseudo-class represents an element that defines the
+  scope of the selector. If no scope is given, <code>:scope</code> is equivalent
+  to <code>:root<code>.
+  <span class="issue">If the scope is not defined by an element, then ???.</span>
+
 <h3 id=target-pseudo>
 The target pseudo-class :target</h3>
 
@@ -1519,7 +1531,7 @@
   </div>
 
 <h2 id=UIstates>
-The UI element states pseudo-classes</h2>
+The UI states pseudo-classes</h2>
 
 <h3 id=enableddisabled>
 The :enabled and :disabled pseudo-classes</h3>
@@ -1568,14 +1580,15 @@
 <h3 id=indeterminate>
 The :indeterminate pseudo-class</h3>
 
-  <p>Radio and checkbox elements can be toggled between checked and
-  unchecked states, but are sometimes in an indeterminate state,
-  neither checked nor unchecked.
-  The <code>:indeterminate</code> pseudo-class applies to such elements.
-  Like the <code>:checked</code> pseudo-class, it applies to all media.</p>
+  <p>The <code>:indeterminate</code> pseudo-class applies to UI elements whose
+  value is in an indeterminate state. For example, radio and checkbox elements
+  can be toggled between checked and unchecked states, but are sometimes in
+  an indeterminate state, neither checked nor unchecked. Similarly a progress
+  meter can be in an indeterminate state when the percent completion is unknown.
 
-  <p>Components of a radio-group initialized with no pre-selected choice
-  are an example of :indeterminate state.</p>
+  <p>Like the <code>:checked</code> pseudo-class, :indeterminate applies to
+  all media. Components of a radio-group initialized with no pre-selected
+  choice, for example, would be :indeterminate even in a static display.</p>
 
 <h2 id=structural-pseudos>
 Tree-Structural pseudo-classes</h2>
@@ -2025,6 +2038,7 @@
 <!-- -->  &lt;tr>&lt;td span="2">D &lt;td>E
 <!-- -->  &lt;tr>&lt;td>F &lt;td span="2">G
 <!-- -->&lt;/table></pre>
+  </div>
 
 <h2 id=combinators>
 Combinators</h2>
@@ -2094,23 +2108,16 @@
   href="#structural-pseudos">:first-child</a></code> pseudo-class
   above.</p>
 
-<h3 id=sibling-combinators>
-Sibling combinators</h3>
-
-  <p>There are two different sibling combinators: the adjacent sibling
-  combinator and the general sibling combinator. In both cases,
-  non-element nodes (e.g. text between elements) are ignored when
-  considering adjacency of elements.</p>
-
-<h4 id=adjacent-sibling-combinators>
-Adjacent sibling combinator</h4>
+<h3 id=adjacent-sibling-combinators>
+Adjacent sibling combinator</h3>
 
   <p>The adjacent sibling combinator is made of the &quot;plus
   sign&quot; (U+002B, <code>+</code>) character that separates two
   compound selectors. The elements represented by the two
   compound selectors share the same parent in the document tree and the element
   represented by the first compound selector immediately precedes the element
-  represented by the second one.</p>
+  represented by the second one. Non-element nodes (e.g. text between elements)
+  are ignored when considering the adjacency of elements.
 
   <div class="example">
    <p>Examples:</p>
@@ -2125,8 +2132,8 @@
   </div>
 
 
-<h4 id=general-sibling-combinators>
-General sibling combinator</h4>
+<h3 id=general-sibling-combinators>
+General sibling combinator</h3>
 
   <p>The general sibling combinator is made of the &quot;tilde&quot;
   (U+007E, <code>~</code>) character that separates two compound selectors.
Received on Tuesday, 12 July 2011 18:17:11 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 12 July 2011 18:17:12 GMT