Skip to content

Commit f8da744

Browse files
committed
css3 lists
1 parent 2721172 commit f8da744

2 files changed

Lines changed: 74 additions & 56 deletions

File tree

css3-speech/Overview.html

Lines changed: 45 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -2402,9 +2402,9 @@ <h2 id=lists><span class=secno>10. </span>List items and counters styles</h2>
24022402

24032403
<p>The &lsquo;<code class=property>list-style-type</code>&rsquo; property
24042404
of <a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> specifies
2405-
three types of list item marker: glyphs, numbering systems, and alphabetic
2406-
systems. The values allowed for this property are also used for the
2407-
counter() function of the &lsquo;<a href="#content-def"><code
2405+
three types of list item markers: glyphs, numbering systems, and
2406+
alphabetic systems. The values allowed for this property are also used for
2407+
the counter() function of the &lsquo;<a href="#content-def"><code
24082408
class=property>content</code></a>&rsquo; property. The CSS Speech module
24092409
defines how to render these styles in the aural dimension, using speech
24102410
synthesis. The &lsquo;<code class=property>list-style-image</code>&rsquo;
@@ -2414,70 +2414,75 @@ <h2 id=lists><span class=secno>10. </span>List items and counters styles</h2>
24142414
list style is provided, the presentation of list items in the aural
24152415
dimension is not specified by the CSS Speech module.
24162416

2417-
<p class=note> Note that screen-readers usually announce well-defined
2418-
structures such as lists or tables regardless of whether special
2419-
information has been authored within the content. These navigation aids
2420-
are typically implementation-dependent. User-agents that support the CSS
2421-
Speech module are expected to handle author-provided aural styles (which
2422-
may or may not announce special structures), and may continue to provide
2423-
implementation-specific navigation cues.
2417+
<p class=note> Note that the working draft of the CSS Lists module <a
2418+
href="#CSS3LIST" rel=biblioentry>[CSS3LIST]<!--{{CSS3LIST}}--></a>
2419+
contains new features which are not yet supported in this version of the
2420+
CSS Speech module. Support for these features will be added later, when
2421+
the CSS Lists draft stabilizes.
24242422

24252423
<dl>
24262424
<dt> <strong>disc, circle, square</strong>
24272425

24282426
<dd>
2429-
<p> These list item marker styles are spoken as the equivalent word for
2430-
the shape, in the user's language.</p>
2427+
<p> These list item styles are spoken as the equivalent word for the
2428+
shape, in the user's language.</p>
24312429

24322430
<dt> <strong>decimal</strong>
24332431

24342432
<dd>
2435-
<p> This list item marker style corresponds to numbers beginning from 1.
2436-
These numbers are spoken as-is by the speech synthesizer, in the user's
2433+
<p> This list item style corresponds to numbers beginning from 1. These
2434+
numbers are spoken as-is by the speech synthesizer, in the user's
24372435
language.</p>
24382436

24392437
<dt> <strong>decimal-leading-zero</strong>
24402438

24412439
<dd>
2442-
<p> This list item marker style corresponds to numbers that are padded
2443-
with initial zeros (e.g., 01, 02, 03, ..., 98, 99). These numbers are
2444-
spoken as individual digits, in the user's language (i.e. just as if the
2440+
<p> This list item style corresponds to numbers that are padded with
2441+
initial zeros (e.g., 01, 02, 03, ..., 98, 99). These numbers are spoken
2442+
as individual digits, in the user's language (i.e. just as if the
24452443
&lsquo;<a href="#speak-as"><code
24462444
class=property>speak-as</code></a>&rsquo; property had been applied with
24472445
the &lsquo;<code class=property>digits</code>&rsquo; value).</p>
24482446

24492447
<dt> <strong>lower-roman, upper-roman</strong>
24502448

24512449
<dd>
2452-
<p> These list item marker styles corresponds to numbers written using
2453-
the roman numeral notation (e.g. [i, ii, iii, iv, v, etc.] or [I, II,
2454-
III, IV, V, etc.]). These numbers are spoken as their &lsquo;<code
2450+
<p> These list item styles corresponds to numbers written using the roman
2451+
numeral notation (e.g. [i, ii, iii, iv, v, etc.] or [I, II, III, IV, V,
2452+
etc.]). These numbers are spoken as their &lsquo;<code
24552453
class=property>decimal</code>&rsquo; equivalents, but the speech
24562454
synthesizer produces an additional cue in the user's language to
24572455
indicate the lower or upper roman style.</p>
24582456

24592457
<dt> <strong>lower-latin, lower-alpha, upper-latin, upper-alpha</strong>
24602458

24612459
<dd>
2462-
<p> These list item marker styles correspond to ASCII alphabetical
2463-
characters (e.g. [a, b, c, ... z] or [A, B, C, ... Z]). They are spoken
2464-
as-is by the speech synthesizer, using the document language.</p>
2460+
<p> These list item styles correspond to ASCII alphabetical characters
2461+
(e.g. [a, b, c, ... z] or [A, B, C, ... Z]). They are spoken as-is by
2462+
the speech synthesizer, using the document language.</p>
24652463

24662464
<dt> <strong>lower-greek</strong>
24672465

24682466
<dd>
2469-
<p> This list item marker style correspond to classical Greek characters
2470-
(e.g. [α, β, γ, ...]). They are spoken using speech synthesis as
2471-
their equivalent "alpha", "beta", "gamma" words, in the user's language.
2472-
</p>
2467+
<p> This list item style correspond to classical Greek characters (e.g.
2468+
[α, β, γ, ...]). They are spoken using speech synthesis as their
2469+
equivalent "alpha", "beta", "gamma" words, in the user's language.</p>
24732470

24742471
<dt> <strong>georgian, armenian</strong>
24752472

24762473
<dd>
2477-
<p> These list item marker styles are not supported by the CSS Speech
2478-
module.</p>
2474+
<p> These list item styles are spoken as numeral equivalents (see
2475+
&lsquo;<code class=property>decimal</code>&rsquo;).</p>
24792476
</dl>
24802477

2478+
<p class=note> Note that screen-readers usually announce well-defined
2479+
structures such as lists or tables regardless of whether special
2480+
information has been authored within the content. These navigation aids
2481+
are typically implementation-dependent. User-agents that support the CSS
2482+
Speech module are expected to handle author-provided aural styles (which
2483+
may or may not announce special structures) whilst continuing to provide
2484+
implementation-specific navigation cues.
2485+
24812486
<h2 id=pronunciation><span class=secno>11. </span> Pronunciation, phonemes</h2>
24822487

24832488
<p class=note>Note that this entire section is non-normative.
@@ -3341,7 +3346,7 @@ <h2 class=no-num id=changes>Appendix D &mdash; Changes from previous draft</h2>
33413346
href="#speak-as"><code class=property>speak-as</code></a>&rsquo; values
33423347
to allow mixing different types.
33433348

3344-
<li>Added support for lists (item styles, numbering, etc.).
3349+
<li>Added support for lists and counters (item styles, numbering, etc.).
33453350

33463351
<li>Adjusted the [initial] value for shorthand properties, to be
33473352
consistent with other CSS specifications (i.e. "see individual
@@ -3506,6 +3511,16 @@ <h3 class=no-num id=other-references>Other references</h3>
35063511
</dd>
35073512
<!---->
35083513

3514+
<dt id=CSS3LIST>[CSS3LIST]
3515+
3516+
<dd>Ian Hickson; Tantek &#199;el&#305;?k. <a
3517+
href="http://www.w3.org/TR/2002/WD-css3-lists-20021107"><cite>CSS3
3518+
module: Lists.</cite></a> 7 November 2002. W3C Working Draft. (Work in
3519+
progress.) URL: <a
3520+
href="http://www.w3.org/TR/2002/WD-css3-lists-20021107">http://www.w3.org/TR/2002/WD-css3-lists-20021107</a>
3521+
</dd>
3522+
<!---->
3523+
35093524
<dt id=PRONUNCIATION-LEXICON>[PRONUNCIATION-LEXICON]
35103525

35113526
<dd>Paolo Baggia. <a

css3-speech/Overview.src.html

Lines changed: 29 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1988,75 +1988,78 @@ <h3 id="mixing-props-voice-duration">The 'voice-duration' property</h3>
19881988
</dd>
19891989
</dl>
19901990
<h2 id="lists">List items and counters styles</h2>
1991-
<p>The 'list-style-type' property of [[!CSS21]] specifies three types of list item marker:
1991+
<p>The 'list-style-type' property of [[!CSS21]] specifies three types of list item markers:
19921992
glyphs, numbering systems, and alphabetic systems. The values allowed for this property are
19931993
also used for the counter() function of the 'content' property. The CSS Speech module defines
19941994
how to render these styles in the aural dimension, using speech synthesis. The
19951995
'list-style-image' property of [[!CSS21]] is ignored, and instead the 'list-style-type' is
19961996
used (if present). When no list style is provided, the presentation of list items in the aural
19971997
dimension is not specified by the CSS Speech module. </p>
1998-
<p class="note"> Note that screen-readers usually announce well-defined structures such as lists
1999-
or tables regardless of whether special information has been authored within the content.
2000-
These navigation aids are typically implementation-dependent. User-agents that support the CSS
2001-
Speech module are expected to handle author-provided aural styles (which may or may not
2002-
announce special structures), and may continue to provide implementation-specific navigation
2003-
cues.</p>
1998+
<p class="note"> Note that the working draft of the CSS Lists module [[CSS3LIST]] contains new
1999+
features which are not yet supported in this version of the CSS Speech module. Support for
2000+
these features will be added later, when the CSS Lists draft stabilizes.</p>
20042001
<dl>
20052002
<dt>
20062003
<strong>disc, circle, square</strong>
20072004
</dt>
20082005
<dd>
2009-
<p> These list item marker styles are spoken as the equivalent word for the shape, in the
2010-
user's language.</p>
2006+
<p> These list item styles are spoken as the equivalent word for the shape, in the user's
2007+
language.</p>
20112008
</dd>
20122009
<dt>
20132010
<strong>decimal</strong>
20142011
</dt>
20152012
<dd>
2016-
<p> This list item marker style corresponds to numbers beginning from 1. These numbers are
2017-
spoken as-is by the speech synthesizer, in the user's language.</p>
2013+
<p> This list item style corresponds to numbers beginning from 1. These numbers are spoken
2014+
as-is by the speech synthesizer, in the user's language.</p>
20182015
</dd>
20192016
<dt>
20202017
<strong>decimal-leading-zero</strong>
20212018
</dt>
20222019
<dd>
2023-
<p> This list item marker style corresponds to numbers that are padded with initial zeros
2024-
(e.g., 01, 02, 03, ..., 98, 99). These numbers are spoken as individual digits, in the
2025-
user's language (i.e. just as if the 'speak-as' property had been applied with the
2026-
'digits' value).</p>
2020+
<p> This list item style corresponds to numbers that are padded with initial zeros (e.g.,
2021+
01, 02, 03, ..., 98, 99). These numbers are spoken as individual digits, in the user's
2022+
language (i.e. just as if the 'speak-as' property had been applied with the 'digits'
2023+
value).</p>
20272024
</dd>
20282025
<dt>
20292026
<strong>lower-roman, upper-roman</strong>
20302027
</dt>
20312028
<dd>
2032-
<p> These list item marker styles corresponds to numbers written using the roman numeral
2033-
notation (e.g. [i, ii, iii, iv, v, etc.] or [I, II, III, IV, V, etc.]). These numbers are
2034-
spoken as their 'decimal' equivalents, but the speech synthesizer produces an additional
2035-
cue in the user's language to indicate the lower or upper roman style.</p>
2029+
<p> These list item styles corresponds to numbers written using the roman numeral notation
2030+
(e.g. [i, ii, iii, iv, v, etc.] or [I, II, III, IV, V, etc.]). These numbers are spoken as
2031+
their 'decimal' equivalents, but the speech synthesizer produces an additional cue in the
2032+
user's language to indicate the lower or upper roman style.</p>
20362033
</dd>
20372034
<dt>
20382035
<strong>lower-latin, lower-alpha, upper-latin, upper-alpha</strong>
20392036
</dt>
20402037
<dd>
2041-
<p> These list item marker styles correspond to ASCII alphabetical characters (e.g. [a, b,
2042-
c, ... z] or [A, B, C, ... Z]). They are spoken as-is by the speech synthesizer, using the
2038+
<p> These list item styles correspond to ASCII alphabetical characters (e.g. [a, b, c, ...
2039+
z] or [A, B, C, ... Z]). They are spoken as-is by the speech synthesizer, using the
20432040
document language. </p>
20442041
</dd>
20452042
<dt>
20462043
<strong>lower-greek</strong>
20472044
</dt>
20482045
<dd>
2049-
<p> This list item marker style correspond to classical Greek characters (e.g. [α, β, γ,
2050-
...]). They are spoken using speech synthesis as their equivalent "alpha", "beta", "gamma"
2051-
words, in the user's language. </p>
2046+
<p> This list item style correspond to classical Greek characters (e.g. [α, β, γ, ...]).
2047+
They are spoken using speech synthesis as their equivalent "alpha", "beta", "gamma" words,
2048+
in the user's language. </p>
20522049
</dd>
20532050
<dt>
20542051
<strong>georgian, armenian</strong>
20552052
</dt>
20562053
<dd>
2057-
<p> These list item marker styles are not supported by the CSS Speech module.</p>
2054+
<p> These list item styles are spoken as numeral equivalents (see 'decimal').</p>
20582055
</dd>
20592056
</dl>
2057+
<p class="note"> Note that screen-readers usually announce well-defined structures such as lists
2058+
or tables regardless of whether special information has been authored within the content.
2059+
These navigation aids are typically implementation-dependent. User-agents that support the CSS
2060+
Speech module are expected to handle author-provided aural styles (which may or may not
2061+
announce special structures) whilst continuing to provide implementation-specific navigation
2062+
cues.</p>
20602063
<h2 id="pronunciation"> Pronunciation, phonemes </h2>
20612064
<p class="note">Note that this entire section is non-normative.</p>
20622065
<p> CSS does not specify how to define the pronunciation (expressed using a well-defined
@@ -2377,7 +2380,7 @@ <h2 class="no-num" id="changes">Appendix D &mdash; Changes from previous draft</
23772380
<li>Removed the "phonemes" property (and its associated "@alphabet" at-rule).</li>
23782381
<li>Renamed 'speakability' to 'speak', and 'speak' to 'speak-as'. Reorganized the 'speak-as'
23792382
values to allow mixing different types.</li>
2380-
<li>Added support for lists (item styles, numbering, etc.).</li>
2383+
<li>Added support for lists and counters (item styles, numbering, etc.).</li>
23812384
<li>Adjusted the [initial] value for shorthand properties, to be consistent with other CSS
23822385
specifications (i.e. "see individual properties"), and removed the erroneous "inherit"
23832386
value.</li>

0 commit comments

Comments
 (0)