[selectors-nonelement] Unified terminology around selector/pseudo-element

Author: Jirka Kosek

selectors-nonelement/Overview.bs

@@ -35,28 +35,34 @@ Non-element Selectors</h2>
 <h3 id="attribute-node-selector">
 Attribute node selector</h3>
 
-	An <dfn export>attribute node pseudo-element</dfn> represents an attribute node in a document tree.
+	An <dfn export>attribute node selector</dfn> represents an attribute node in a document tree.
 	Its syntax is:
 
 	<pre class='prod'><dfn selector>::attr()</dfn> = ::attr( <<qualified-name>> )</pre>
 
 	Where <dfn>&lt;qualified-name></dfn> is a <a spec=css-namespaces>CSS qualified name</a>.
 
-	The pseudo-element matches an attribute node with the given qualified name,
+	The selector uses <a spec=selectors>pseudo-element</a> syntax.
+
+	The selector matches an attribute node with the given qualified name,
 	if such an attribute exists on the <a spec=selectors>originating element</a>.
 
 	<div class="example">
-		The following ITS rules use an attribute node selector to switch off translatability of <code>title</code> attributes on <code>abbr</code> elements.
+		For example,
+		the selector ''::attr(title)'' selects all the <code>title</code> attributes in the document.
+	</div>
 
+	<div class="example">
+		The following ITS rules use attribute node selector to switch off
+                translatability of <code>title</code> attribute on <code>abbr</code> elements.
 		<pre>
-			&lt;rules xmlns="http://www.w3.org/2005/11/its"
-			       version="2.0"
-			       queryLanguage="css">
-			  &lt;translateRule selector="abbr::attr(title)" translate="no"/>
-			&lt;/rules>
+&lt;rules xmlns="http://www.w3.org/2005/11/its"
+       version="2.0"
+       queryLanguage="css">
+  &lt;translateRule selector="abbr::attr(title)" translate="no"/>
+&lt;/rules>
 		</pre>
 
 	</div>
 
-	Although entirely valid in Selectors used in the scope of CSS,
-	attribute node pseudo-elements never generate boxes.
+	In CSS, <a>attribute node selectors</a> never generate boxes.

selectors-nonelement/Overview.html

@@ -150,28 +150,34 @@ <h2 class="heading settled heading" data-level=2 id=non-element-selectors><span
 <h3 class="heading settled heading" data-level=2.1 id=attribute-node-selector><span class=secno>2.1 </span><span class=content>
 Attribute node selector</span><a class=self-link href=#attribute-node-selector></a></h3>
 
-<p>	An <dfn data-dfn-type=dfn data-export="" id=attribute-node-pseudo-element>attribute node pseudo-element<a class=self-link href=#attribute-node-pseudo-element></a></dfn> represents an attribute node in a document tree.
+<p>	An <dfn data-dfn-type=dfn data-export="" id=attribute-node-selector0>attribute node selector<a class=self-link href=#attribute-node-selector0></a></dfn> represents an attribute node in a document tree.
 	Its syntax is:
 
 <pre class=prod><dfn class=css-code data-dfn-type=selector data-export="" id=selectordef-attr>::attr()<a class=self-link href=#selectordef-attr></a></dfn> = ::attr( <a class="production css-code" data-link-type=type href=#typedef-qualified-name title="<qualified-name>">&lt;qualified-name&gt;</a> )</pre>
 <p>	Where <dfn class=css-code data-dfn-type=type data-export="" id=typedef-qualified-name>&lt;qualified-name&gt;<a class=self-link href=#typedef-qualified-name></a></dfn> is a <a data-link-spec=css-namespaces data-link-type=dfn href=http://dev.w3.org/csswg/css-namespaces-1/#css-qualified-name title="css qualified name">CSS qualified name</a>.
 
-<p>	The pseudo-element matches an attribute node with the given qualified name,
+<p>	The selector uses <a data-link-spec=selectors data-link-type=dfn href=http://dev.w3.org/csswg/selectors-4/#pseudo-element title=pseudo-element>pseudo-element</a> syntax.
+
+<p>	The selector matches an attribute node with the given qualified name,
 	if such an attribute exists on the <a data-link-spec=selectors data-link-type=dfn href=http://dev.w3.org/csswg/selectors-4/#originating-element title="originating element">originating element</a>.
 
 	<div class=example>
-		The following ITS rules use an attribute node selector to switch off translatability of <code>title</code> attributes on <code>abbr</code> elements.
+		For example,
+		the selector <span class=css data-link-type=maybe title=::attr(title)>::attr(title)</span> selects all the <code>title</code> attributes in the document.
+	</div>
 
-		<pre>  &lt;rules xmlns="http://www.w3.org/2005/11/its"
-         version="2.0"
-         queryLanguage="css"&gt;
-    &lt;translateRule selector="abbr::attr(title)" translate="no"/&gt;
-  &lt;/rules&gt;
+	<div class=example>
+		The following ITS rules use attribute node selector to switch off
+                translatability of <code>title</code> attribute on <code>abbr</code> elements.
+		<pre>&lt;rules xmlns="http://www.w3.org/2005/11/its"
+       version="2.0"
+       queryLanguage="css"&gt;
+  &lt;translateRule selector="abbr::attr(title)" translate="no"/&gt;
+&lt;/rules&gt;
 </pre>
 	</div>
 
-<p>	Although entirely valid in Selectors used in the scope of CSS,
-	attribute node pseudo-elements never generate boxes.
+<p>	In CSS, <a data-link-type=dfn href=#attribute-node-selector0 title="attribute node selectors">attribute node selectors</a> never generate boxes.
 
 <h2 class="no-ref no-num heading settled heading" id=conformance><span class=content>
 Conformance</span><a class=self-link href=#conformance></a></h2>
@@ -308,7 +314,7 @@ <h2 class="no-num no-ref heading settled heading" id=index><span class=content>
 Index</span><a class=self-link href=#index></a></h2>
 <div data-fill-with=index><ul class=indexlist>
 <li>::attr(), <a href=#selectordef-attr title="section 2.1">2.1</a>
-<li>attribute node pseudo-element, <a href=#attribute-node-pseudo-element title="section 2.1">2.1</a>
+<li>attribute node selector, <a href=#attribute-node-selector0 title="section 2.1">2.1</a>
 <li>&lt;qualified-name&gt;, <a href=#typedef-qualified-name title="section 2.1">2.1</a>
 </ul></div>