Skip to content

Commit 861a5e0

Browse files
committed
[css-counter-styles-3] Clarify that speak-as represents spoken output. It may be used for other AT. w3c#6040
1 parent f1bc81f commit 861a5e0

1 file changed

Lines changed: 3 additions & 4 deletions

File tree

css-counter-styles-3/Overview.bs

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1113,8 +1113,10 @@ Speech Synthesis: the '@counter-style/speak-as' descriptor</h3>
11131113

11141114
A counter style can be constructed with a meaning that is obvious visually,
11151115
but impossible to meaningfully represent via a speech synthesizer or other non-visual means,
1116-
or possible but nonsensical when naively transformed.
1116+
or possible but nonsensical when naively read out loud.
11171117
The '@counter-style/speak-as' descriptor describes how to synthesize the spoken form of a counter formatted with the given counter style.
1118+
Assistive technologies should use this spoken form when reading out the counter style,
1119+
and may use the 'speak-as' value to inform transformations to outputs other than speech.
11181120
Values have the following meanings:
11191121

11201122
<dl dfn-for="@counter-style/speak-as" dfn-type=value>
@@ -1166,9 +1168,6 @@ Speech Synthesis: the '@counter-style/speak-as' descriptor</h3>
11661168
for the counter styles participating in the loop.
11671169
</dl>
11681170

1169-
Note: The values above are defined by referring to "speaking" a value,
1170-
but should be understand as referring to any non-visual means of representing text.
1171-
11721171
<div class='example'>
11731172
The ability to defer pronunciation to another counter style can help when the symbols being used aren't actually letters.
11741173
For example, here's a possible definition of a ''circled-lower-latin'' counter-style, using some special Unicode characters:

0 commit comments

Comments
 (0)