Skip to content

Commit 5197f78

Browse files
committed
[css-counter-styles] Add speak-as:words, rename other values as decided by group.
--HG-- extra : rebase_source : 8e6185cd6dfb86dd49b940017477142ae8c52a68
1 parent f00ebed commit 5197f78

3 files changed

Lines changed: 95 additions & 59 deletions

File tree

css-counter-styles/Overview.bs

Lines changed: 19 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -886,7 +886,7 @@ Speech Synthesis: the 'speak-as' descriptor</h3>
886886
<pre class='descdef'>
887887
Name: speak-as
888888
For: @counter-style
889-
Value: auto | numeric | alphabetic | bullet | <<counter-style-name>>
889+
Value: auto | bullets | numbers | words | spell-out | <<counter-style-name>>
890890
Initial: auto
891891
</pre>
892892

@@ -899,31 +899,38 @@ Speech Synthesis: the 'speak-as' descriptor</h3>
899899
<dl dfn-for="@counter-style/speak-as" dfn-type=value>
900900
<dt><dfn>auto</dfn>
901901
<dd>
902-
If the counter style's 'system' is ''system/alphabetic'',
903-
this value has the same effect as ''speak-as/alphabetic''.
902+
If the counter style's 'system' is ''alphabetic'',
903+
this value has the same effect as ''spell-out''.
904904
If the 'system' is ''cyclic'',
905-
this value has the same effect as ''speak-as/bullet''.
905+
this value has the same effect as ''bullets''.
906906
If the 'system' is ''override'',
907907
this value has the same effect as ''speak-as/auto'' would have for the overridden style.
908-
Otherwise, this value has the same effect as ''speak-as/numeric''.
908+
Otherwise, this value has the same effect as ''numbers''.
909909

910-
<dt><dfn>numeric</dfn>
910+
<dt><dfn>bullets</dfn>
911+
<dd>
912+
The UA speaks a UA-defined phrase or audio cue that represents an unordered list item being read out.
913+
914+
<dt><dfn>numbers</dfn>
911915
<dd>
912916
The counter's value is spoken as a number in the document language.
913917

914-
<dt><dfn>alphabetic</dfn>
918+
<dt><dfn>words</dfn>
919+
<dd>
920+
<i>Generate a counter representation</i> for the value as normal,
921+
then speak it as normal text in the document language.
922+
923+
924+
<dt><dfn>spell-out</dfn>
915925
<dd>
916926
<i>Generate a counter representation</i> for the value as normal,
917927
then spell it out letter-by-letter in the document language.
918928
If the UA does not know how to pronounce the symbols,
919-
it may handle it as <a value for=speak-as>numeric</a>.
929+
it may handle it as ''numbers''.
920930

921931
For example, ''lower-greek'' in English would be read out as "alpha", "beta", "gamma", etc.
922932
Conversely, ''upper-latin'' in French would be read out as (in phonetic notation) /a/, /be/, /se/, etc.
923933

924-
<dt><dfn>bullet</dfn>
925-
<dd>
926-
The UA speaks a UA-defined phrase or audio cue that represents an unordered list item being read out.
927934

928935
<dt><dfn><<counter-style-name>></dfn>
929936
<dd>
@@ -1372,7 +1379,7 @@ Complex Predefined Counter Styles</h2>
13721379
For example, an author can reference one of these styles in an ''override'' system,
13731380
reusing the algorithm but swapping out some of the other descriptors.
13741381

1375-
All of the counter styles defined in this section have a <a title='speak-as' descriptor>spoken form</a> of <a value for=speak-as>numeric</a>,
1382+
All of the counter styles defined in this section have a <a title='speak-as' descriptor>spoken form</a> of ''numbers'',
13761383
and <i>use a negative sign</i>.
13771384

13781385

0 commit comments

Comments
 (0)