- 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
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><symbols-function></dfn> = symbols( <symbols> [as <type>]? )</pre>
+ id=type-symbols-function><symbols-function></dfn> = symbols( <type>? [ <string> | <image> ]+ )</pre>
- <p>Where <symbols> is a valid value for the ‘<a
- href="#descdef-symbols"><code class=property>symbols</code></a>’
- descriptor in a ‘<code class=css>@counter-style</code>’ rule,
- and <type> is one of the following keywords: ‘<code
+ <p>Where <type> is one of the following keywords: ‘<code
class=css>repeating</code>’, ‘<code
class=css>numeric</code>’, ‘<code
class=css>alphabetic</code>’, ‘<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 ‘<a href="#descdef-symbols"><code
+ class=css>symbols()</code></a>’ function only allows strings and
+ images, while the ‘<a href="#descdef-symbols"><code
+ class=property>symbols</code></a>’ descriptor of a ‘<code
+ class=css>@counter-style</code>’ 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'><symbols-function></dfn> = symbols( <symbols> [as <type>]? )</pre>
+ <pre><dfn id='type-symbols-function'><symbols-function></dfn> = symbols( <type>? [ <string> | <image> ]+ )</pre>
- <p>Where <symbols> is a valid value for the 'symbols' descriptor in a ''@counter-style'' rule, and <type> is one of the following keywords: ''repeating'', ''numeric'', ''alphabetic'', ''symbolic'', or ''non-repeating''.</p>
+ <p>Where <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 <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 UTC