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

csswg/css3-lists Overview.html,1.112,1.113 Overview.src.html,1.159,1.160

From: Tab Atkins Jr.. via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 30 Nov 2011 01:51:43 +0000
To: public-css-commits@w3.org
Message-Id: <E1RVZKp-000875-Jj@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-lists
In directory hutz:/tmp/cvs-serv31173

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Switched symbols() to put type first, refined the definition to exclude identifiers.

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.html,v
retrieving revision 1.112
retrieving revision 1.113
diff -u -d -r1.112 -r1.113
--- Overview.html	30 Nov 2011 01:34:40 -0000	1.112
+++ Overview.html	30 Nov 2011 01:51:41 -0000	1.113
@@ -2324,12 +2324,9 @@
    is:
 
   <pre><dfn
-   id=type-symbols-function>&lt;symbols-function></dfn> = symbols( &lt;symbols> [as &lt;type>]? )</pre>
+   id=type-symbols-function>&lt;symbols-function></dfn> = symbols( &lt;type>? [ &lt;string> | &lt;image> ]+ )</pre>
 
-  <p>Where &lt;symbols> is a valid value for the &lsquo;<a
-   href="#descdef-symbols"><code class=property>symbols</code></a>&rsquo;
-   descriptor in a &lsquo;<code class=css>@counter-style</code>&rsquo; rule,
-   and &lt;type> is one of the following keywords: &lsquo;<code
+  <p>Where &lt;type> is one of the following keywords: &lsquo;<code
    class=css>repeating</code>&rsquo;, &lsquo;<code
    class=css>numeric</code>&rsquo;, &lsquo;<code
    class=css>alphabetic</code>&rsquo;, &lsquo;<code
@@ -2374,7 +2371,7 @@
 
    <p>On the other hand, specifying the type of counter, like so:</p>
 
-   <pre>ol { list-style: symbols("*" "\2020" "\2021" "\A7" as repeating); }</pre>
+   <pre>ol { list-style: symbols(repeating "*" "\2020" "\2021" "\A7"); }</pre>
 
    <p>will produce lists that look like:</p>
 
@@ -2388,6 +2385,12 @@
 ‡   Seven</pre>
   </div>
 
+  <p class=note>Note that the &lsquo;<a href="#descdef-symbols"><code
+   class=css>symbols()</code></a>&rsquo; function only allows strings and
+   images, while the &lsquo;<a href="#descdef-symbols"><code
+   class=property>symbols</code></a>&rsquo; descriptor of a &lsquo;<code
+   class=css>@counter-style</code>&rsquo; rule also allows identifiers.
+
   <h2 id=ua-stylesheet><span class=secno>10. </span> Predefined Counter
    Styles</h2>
 

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-lists/Overview.src.html,v
retrieving revision 1.159
retrieving revision 1.160
diff -u -d -r1.159 -r1.160
--- Overview.src.html	30 Nov 2011 01:34:40 -0000	1.159
+++ Overview.src.html	30 Nov 2011 01:51:41 -0000	1.160
@@ -1551,9 +1551,9 @@
 
 	<p>The previous chapter specified a way to define custom counter styles.  However, counter styles are sometimes used only once in a stylesheet, and defining a full ''@counter-style'' rule can be overkill for this case (not to mention the possibility of unintentional name collisions).  To address this case, the ''symbols()'' function provides a simple way to define an anonymous counter style as an inline value.  It does not provide the full feature-set of the ''@counter-style'' rule, but provides a sufficient subset to still be useful.  The syntax of the ''symbols()'' rule is:</p>
 
-	<pre><dfn id='type-symbols-function'>&lt;symbols-function></dfn> = symbols( &lt;symbols> [as &lt;type>]? )</pre>
+	<pre><dfn id='type-symbols-function'>&lt;symbols-function></dfn> = symbols( &lt;type>? [ &lt;string> | &lt;image> ]+ )</pre>
 
-	<p>Where &lt;symbols> is a valid value for the 'symbols' descriptor in a ''@counter-style'' rule, and &lt;type> is one of the following keywords: ''repeating'', ''numeric'', ''alphabetic'', ''symbolic'', or ''non-repeating''.</p>
+	<p>Where &lt;type> is one of the following keywords: ''repeating'', ''numeric'', ''alphabetic'', ''symbolic'', or ''non-repeating''.</p>
 
 	<p>The ''symbols()'' function defines an anonymous counter style with no <i title="counter-name">name</i>, a <i title="counter-prefix">prefix</i> and <i title="counter-suffix">suffix</i> of ''""'' (the empty string), a <i title="counter-lower-bound">lower bound</i> of negative infinity, an <i title="counter-upper-bound">upper bound</i> of infinity, an <i title="counter-fallback">fallback style</i> of ''decimal'', and a <i title="counter-negative">negative sign</i> of "\2D" ("-" hyphen-minus).  The counter style's <i title="counter-algorithm">algorithm</i> is constructed by consulting the previous chapter using the provided type - or ''symbolic'' if the type was omitted - and the provided &lt;symbols> as the value of the 'symbols' property.</p>
 
@@ -1575,7 +1575,7 @@
 
 		<p>On the other hand, specifying the type of counter, like so:</p>
 		
-		<pre>ol { list-style: symbols("*" "\2020" "\2021" "\A7" as repeating); }</pre>
+		<pre>ol { list-style: symbols(repeating "*" "\2020" "\2021" "\A7"); }</pre>
 
 		<p>will produce lists that look like:</p>
 		
@@ -1589,6 +1589,8 @@
 ‡   Seven</pre>
 	</div>
 
+	<p class='note'>Note that the ''symbols()'' function only allows strings and images, while the 'symbols' descriptor of a ''@counter-style'' rule also allows identifiers.</p>
+
 
 <h2 id='ua-stylesheet'>
 Predefined Counter Styles</h2>
Received on Wednesday, 30 November 2011 01:51:48 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 30 November 2011 01:51:48 GMT