speak-as
Описание speak-as указывает, как символ счётчика, созданного с помощью заданного @counter-style, будет представлен в устной форме. Например, автор может указать, чтобы символ счётчика произносился как его числовое значение или просто воспроизводился звуковым сигналом.
Синтаксис
/* Keyword values */ speak-as: auto; speak-as: bullets; speak-as: numbers; speak-as: words; speak-as: spell-out; /* @counter-style name value */ speak-as: <counter-style-name>;
Значения
auto-
Если значение
speak-asзадано какauto, то эффективное значениеspeak-asбудет определяться на основе значения описателяsystem:- Если значение
systemравноalphabetic, эффективное значениеspeak-asбудет равноspell-out. - Если
systemравноcyclic, эффективное значениеspeak-asбудет равноbullets. - Если
systemравноextends, значениеspeak-asбудет таким же, как если быspeak-as: autoбыло указано в расширенном стиле. - Во всех остальных случаях, указание
autoимеет тот же эффект, что и указаниеspeak-as: numbers.
- Если значение
bullets-
Будет прочитана фраза или звуковой сигнал, определённый пользовательским агентом для представления элемента неупорядоченного списка.
numbers-
Будет прочитано числовое значение счётчика на языке документа.
words-
Пользовательский агент сгенерирует значение счётчика в обычном формате и прочитает его как слово на языке документа.
spell-out-
Пользовательский агент сгенерирует представление счётчика в обычном формате и прочитает его букву за буквой. Если пользовательский агент не знает, как прочитать определённый символ счётчика, он может прочитать его так, как будто значение
speak-asбылоnumbers. <counter-style-name>-
Имя другого стиля счётчика, указанное как
<custom-ident>. Если указано, счётчик будет прочитан в формате, указанном в этом стиле счётчика, так же, как если бы был указан описательfallback. Если указанного стиля не существует, по умолчанию используетсяspeak-as, равныйauto.
Доступность
Поддержка вспомогательных технологий для свойства speak-as очень ограничена. Не полагайтесь на неё для передачи информации, критически важной для понимания назначения страницы.
Формальное определение
| Связанное правило | @counter-style |
|---|---|
| Начальное значение | auto |
| Вычисленное значение | как указано |
Формальный синтаксис
Примеры
Установка устной формы для счётчика
В этом примере система счётчика фиксирована с использованием нечитаемых символов для визуальных маркеров. Однако описатель speak-as используется для установки маркеров элементов списка в виде чисел в дереве доступности. При поддержке, числа, а не визуальные маркеры, будут читаться средствами чтения с экрана.
Чтобы увидеть результат описателя speak-as, используйте вспомогательные технологии, такие как VoiceOver, или другой экранный диктор, или откройте панель доступности в инструментах разработчика браузера, который поддерживает speak-as.
HTML
<ul class="list"> <li>I had one apple</li> <li>I ate two bananas</li> <li>I devoured three oranges</li> <li>I am not hungry for dinner</li> <li>But I'll have five scoops of ice cream for dessert</li> </ul>
CSS
@counter-style speak-as-example {
system: fixed;
symbols: ;
suffix: " ";
speak-as: numbers;
}
.list {
list-style: speak-as-example;
}
Результат
Спецификации
| Спецификация |
|---|
| CSS Counter Styles Level 3 # counter-style-speak-as |
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
speak-as |
91 | 91 | 33 | 77 | Нет | 91 | 33 | 64 | Нет | 16.0 | 91 |
См. также
- Другие
@counter-styleописатели:system,symbols,additive-symbols,negative,prefix,suffix,range,padиfallback -
list-style,list-style-image,list-style-position -
symbols(): функциональная нотация для создания анонимных стилей счётчика. - Модуль CSS стилей счётчика
- Модуль CSS списков и счётчиков
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/@counter-style/speak-as