Skip to content

Commit 28f18cd

Browse files
committed
[css-counter-styles] Clarify that speak-as:bullet speaks as an unordered list item. Fix typos.
1 parent bab45a4 commit 28f18cd

2 files changed

Lines changed: 13 additions & 11 deletions

File tree

css-counter-styles/Overview.html

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -931,7 +931,7 @@ <h3 class="heading settled heading" data-level=3.9 id=counter-style-speak-as><sp
931931
The <a class=property data-link-type=propdesc href=#descdef-speak-as title=speak-as>speak-as</a> descriptor describes how to synthesize the spoken form of a counter formatted with the given counter style.
932932
Values have the following meanings:
933933

934-
<dl data-dfn-for=@counter-style/speak-as>
934+
<dl data-dfn-for=@counter-style/speak-as data-dfn-type=value>
935935
<dt><dfn class=css-code data-dfn-for=@counter-style/speak-as data-dfn-type=value data-export="" id=valuedef-auto>auto<a class=self-link href=#valuedef-auto></a></dfn>
936936
<dd>
937937
If the counter style’s <a class=property data-link-type=propdesc href=#descdef-system title=system>system</a> is <a class=css-code data-link-for=system data-link-type=value href=#valuedef-alphabetic0 title=alphabetic>alphabetic</a>, this value computes to <a class=css-code data-link-for=speak-as data-link-type=value href=#valuedef-alphabetic title=alphabetic>alphabetic</a>.
@@ -954,11 +954,12 @@ <h3 class="heading settled heading" data-level=3.9 id=counter-style-speak-as><sp
954954

955955
<dt><dfn class=css-code data-dfn-for=@counter-style/speak-as data-dfn-type=value data-export="" id=valuedef-bullet>bullet<a class=self-link href=#valuedef-bullet></a></dfn>
956956
<dd>
957-
The UA speaks a UA-defined phrase or audio cue that represents a list item being read out.
957+
The UA speaks a UA-defined phrase or audio cue that represents an unordered list item being read out.
958958

959959
<dt><dfn class=css-code data-dfn-for=@counter-style/speak-as data-dfn-type=value data-export="" id=valuedef-counter-style-name><a class="production css-code" data-link-type=type href=#typedef-counter-style-name title="<counter-style-name>">&lt;counter-style-name&gt;</a><a class=self-link href=#valuedef-counter-style-name></a></dfn>
960960
<dd>
961-
The counter’s value is instead spoken out in the specific style.
961+
The counter’s value is instead spoken out in the specified style
962+
(similar to the behavior of the <a class=property data-link-type=propdesc href=#descdef-fallback title=fallback>fallback</a> descriptor when generating representations for a counter value).
962963
If the specified style does not exist,
963964
this value is treated as <a class=css data-link-for=speak-as data-link-type=maybe href=#valuedef-auto title=auto>auto</a>.
964965
If a loop is detected when following <a class=property data-link-type=propdesc href=#descdef-speak-as title=speak-as>speak-as</a> references,

css-counter-styles/Overview.src.html

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -874,18 +874,18 @@ <h3 id='counter-style-speak-as'>
874874
The 'speak-as' descriptor describes how to synthesize the spoken form of a counter formatted with the given counter style.
875875
Values have the following meanings:
876876

877-
<dl dfn-for="@counter-style/speak-as">
878-
<dt><dfn value>auto</dfn>
877+
<dl dfn-for="@counter-style/speak-as" dfn-type=value>
878+
<dt><dfn>auto</dfn>
879879
<dd>
880880
If the counter style's 'system' is <a value for=system>alphabetic</a>, this value computes to <a value for=speak-as>alphabetic</a>.
881881
If the 'system' is ''cyclic'', this value computes to ''bullet''.
882882
Otherwise, this value computes to <a value for=speak-as>numeric</a>.
883883

884-
<dt><dfn value>numeric</dfn>
884+
<dt><dfn>numeric</dfn>
885885
<dd>
886886
The counter's value is spoken as a number in the document language.
887887

888-
<dt><dfn value>alphabetic</dfn>
888+
<dt><dfn>alphabetic</dfn>
889889
<dd>
890890
<i>Generate a counter representation</i> for the value as normal,
891891
then spell it out letter-by-letter in the document language.
@@ -895,13 +895,14 @@ <h3 id='counter-style-speak-as'>
895895
For example, ''lower-greek'' in English would be read out as "alpha", "beta", "gamma", etc.
896896
Conversely, ''upper-latin'' in French would be read out as (in phonetic notation) /a/, /be/, /se/, etc.
897897

898-
<dt><dfn value>bullet</dfn>
898+
<dt><dfn>bullet</dfn>
899899
<dd>
900-
The UA speaks a UA-defined phrase or audio cue that represents a list item being read out.
900+
The UA speaks a UA-defined phrase or audio cue that represents an unordered list item being read out.
901901

902-
<dt><dfn value><<counter-style-name>></dfn>
902+
<dt><dfn><<counter-style-name>></dfn>
903903
<dd>
904-
The counter's value is instead spoken out in the specific style.
904+
The counter's value is instead spoken out in the specified style
905+
(similar to the behavior of the 'fallback' descriptor when generating representations for a counter value).
905906
If the specified style does not exist,
906907
this value is treated as ''speak-as/auto''.
907908
If a loop is detected when following 'speak-as' references,

0 commit comments

Comments
 (0)