Skip to content

Commit 7045a94

Browse files
committed
[css-counter-styles] Editorial tweak of symbols() section.
1 parent 71221a5 commit 7045a94

File tree

2 files changed

+27
-33
lines changed

2 files changed

+27
-33
lines changed

css-counter-styles/Overview.html

+20-22
Original file line numberDiff line numberDiff line change
@@ -1275,15 +1275,13 @@ <h2 id=symbols-function><span class=secno>4. </span> Defining Anonymous
12751275
Counter Styles: the ‘<a href="#descdef-symbols"><code
12761276
class=css>symbols()</code></a>’ function</h2>
12771277

1278-
<p> The previous chapter specified a way to define custom counter styles.
1279-
However, counter styles are sometimes used only once in a stylesheet, and
1278+
<p> The ‘<a href="#descdef-symbols"><code
1279+
class=css>symbols()</code></a>’ function allows a <a
1280+
href="#counter-style"><i>counter style</i></a> to be defined inline in a
1281+
property value, for when a style is used only once in a stylesheet and
12801282
defining a full ‘<a href="#at-counter-style"><code
1281-
class=css>@counter-style</code></a>’ rule can be overkill for this case
1282-
(not to mention the possibility of unintentional name collisions). To
1283-
address this case, the ‘<a href="#descdef-symbols"><code
1284-
class=css>symbols()</code></a>’ function provides a simple way to define
1285-
an anonymous counter style as an inline value. It does not provide the
1286-
full feature-set of the ‘<a href="#at-counter-style"><code
1283+
class=css>@counter-style</code></a>’ rule would be overkill. It does not
1284+
provide the full feature-set of the ‘<a href="#at-counter-style"><code
12871285
class=css>@counter-style</code></a>’ rule, but provides a sufficient
12881286
subset to still be useful. The syntax of the ‘<a
12891287
href="#descdef-symbols"><code class=css>symbols()</code></a>’ rule is:
@@ -1304,20 +1302,20 @@ <h2 id=symbols-function><span class=secno>4. </span> Defining Anonymous
13041302
href="#prefix"><i title=counter-prefix>prefix</i></a> and <a
13051303
href="#suffix"><i title=counter-suffix>suffix</i></a> of ‘<code
13061304
class=css>""</code>’ (the empty string), a <a href="#range"><i
1307-
title=counter-range>range</i></a> from negative infinity to positive
1308-
infinity, n <a href="#fallback-style"><i title=counter-fallback>fallback
1309-
style</i></a> of ‘<a href="#decimal"><code
1310-
class=css>decimal</code></a>’, and a <a href="#negative-sign"><i
1311-
title=counter-negative>negative sign</i></a> of "\2D" ("-" hyphen-minus).
1312-
The counter style's <a href="#algorithm"><i
1305+
title=counter-range>range</i></a> of ‘<code class=css>auto</code>’, a
1306+
<a href="#fallback-style"><i title=counter-fallback>fallback style</i></a>
1307+
of ‘<a href="#decimal"><code class=css>decimal</code></a>’, and a <a
1308+
href="#negative-sign"><i title=counter-negative>negative sign</i></a> of
1309+
"\2D" ("-" hyphen-minus). The counter style's <a href="#algorithm"><i
13131310
title=counter-algorithm>algorithm</i></a> is constructed by consulting the
1314-
previous chapter using the provided type - or ‘<a href="#symbolic"><code
1315-
class=css>symbolic</code></a>’ if the type was omitted - and the
1316-
provided &lt;string>s and &lt;image>s as the value of the ‘<a
1317-
href="#descdef-symbols"><code class=property>symbols</code></a>
1318-
property. If the type is ‘<a href="#fixed"><code
1319-
class=css>fixed</code></a>’, the <a href="#first-symbol-value"><i>first
1320-
symbol value</i></a> is ‘<code class=css>1</code>’.
1311+
previous chapter using the provided type — or ‘<a
1312+
href="#symbolic"><code class=css>symbolic</code></a>’ if the type was
1313+
omitted — and the provided &lt;string>s and &lt;image>s as the value of
1314+
the ‘<a href="#descdef-symbols"><code
1315+
class=property>symbols</code></a>’ property. If the type is ‘<a
1316+
href="#fixed"><code class=css>fixed</code></a>’, the <a
1317+
href="#first-symbol-value"><i>first symbol value</i></a> is ‘<code
1318+
class=css>1</code>’.
13211319

13221320
<div class=example>
13231321
<p> This code:
@@ -1337,7 +1335,7 @@ <h2 id=symbols-function><span class=secno>4. </span> Defining Anonymous
13371335

13381336
<p> On the other hand, specifying the type of counter, like so:
13391337

1340-
<pre>ol { list-style: symbols(repeating "*" "\2020" "\2021" "\A7"); }</pre>
1338+
<pre>ol { list-style: symbols(cyclic "*" "\2020" "\2021" "\A7"); }</pre>
13411339

13421340
<p> will produce lists that look like:
13431341

css-counter-styles/Overview.src.html

+7-11
Original file line numberDiff line numberDiff line change
@@ -900,12 +900,8 @@ <h2 id='symbols-function'>
900900
Defining Anonymous Counter Styles: the ''symbols()'' function</h2>
901901

902902
<p>
903-
The previous chapter specified a way to define custom counter styles.
904-
However, counter styles are sometimes used only once in a stylesheet,
905-
and defining a full ''@counter-style'' rule can be overkill for this case
906-
(not to mention the possibility of unintentional name collisions).
907-
To address this case,
908-
the ''symbols()'' function provides a simple way to define an anonymous counter style as an inline value.
903+
The ''symbols()'' function allows a <i>counter style</i> to be defined inline in a property value,
904+
for when a style is used only once in a stylesheet and defining a full ''@counter-style'' rule would be overkill.
909905
It does not provide the full feature-set of the ''@counter-style'' rule,
910906
but provides a sufficient subset to still be useful.
911907
The syntax of the ''symbols()'' rule is:
@@ -921,12 +917,12 @@ <h2 id='symbols-function'>
921917
with no <i title="counter-name">name</i>,
922918
a <i title="counter-prefix">prefix</i>
923919
and <i title="counter-suffix">suffix</i> of ''""'' (the empty string),
924-
a <i title="counter-range">range</i> from negative infinity to positive infinity,
925-
n <i title="counter-fallback">fallback style</i> of ''decimal'',
920+
a <i title="counter-range">range</i> of ''auto'',
921+
a <i title="counter-fallback">fallback style</i> of ''decimal'',
926922
and a <i title="counter-negative">negative sign</i> of "\2D" ("-" hyphen-minus).
927923
The counter style's <i title="counter-algorithm">algorithm</i> is constructed
928-
by consulting the previous chapter using the provided type
929-
- or ''symbolic'' if the type was omitted -
924+
by consulting the previous chapter using the provided type&nbsp;&mdash;
925+
or ''symbolic'' if the type was omitted&nbsp;&mdash;
930926
and the provided &lt;string>s and &lt;image>s as the value of the 'symbols' property.
931927
If the type is ''fixed'', the <i>first symbol value</i> is ''1''.
932928

@@ -951,7 +947,7 @@ <h2 id='symbols-function'>
951947
<p>
952948
On the other hand, specifying the type of counter, like so:
953949

954-
<pre>ol { list-style: symbols(repeating "*" "\2020" "\2021" "\A7"); }</pre>
950+
<pre>ol { list-style: symbols(cyclic "*" "\2020" "\2021" "\A7"); }</pre>
955951

956952
<p>
957953
will produce lists that look like:

0 commit comments

Comments
 (0)