Spec-Zone.ru › CSS

символы

Описание symbols CSS для правила @counter-style используется для задания символов, используемых для представления счётчиков в указанной системе счёта. Указание этого описания обязательно, когда значение описания system равно cyclic, numeric, alphabetic, symbolic, или fixed.

Синтаксис

symbols: A B C D E;
symbols: "\24B6" "\24B7" "\24B8" D E;
symbols: "0" "1" "2" "4" "5" "6" "7" "8" "9";
symbols: url("one.svg") url("two.svg") url("three.svg");
symbols: indic-numbers;

Значения

Описание symbols задаётся как список одного или более значений <symbol>, разделённых пробелами.

<symbol>

Определяет символ, используемый в системе счёта. Каждый символ в списке может быть либо <string>, либо <image>, либо <custom-ident>. Значение <image>, в свою очередь, может быть задано как <url> или <gradient>.

Примечание: При использовании идентификатора для символа обратите внимание, что ASCII-символы, не являющиеся буквами, такие как *, ", и \, не считаются идентификаторами. Они должны быть либо заключены в кавычки в качестве строки, либо экранированы.

Описание

Символ может быть строкой, изображением или идентификатором. Он используется внутри правила @counter-style at-rule.

Когда значение описания system равно cyclic, numeric, alphabetic, symbolic, или fixed, необходимо указать описание symbols. Для системы additive используйте описание additive-symbols для задания символов.

Хотя пробел между символами в кавычках не обязателен, он делает CSS более читабельным. Чтобы использовать кавычку в качестве символа, либо экранируйте символ кавычки, либо заключите его в разные кавычки, например, "'".

При определении символов с помощью идентификаторов вместо строк, убедитесь, что используются правила синтаксиса идентификаторов. Например, как отмечено выше, ASCII-символы, не являющиеся буквами, такие как * не являются идентификаторами и должны быть либо заключены в кавычки, либо экранированы. Шестнадцатеричные экранированные символы следуют за пробелом. Этот пробел может выглядеть как пробел, разделяющий два идентификатора, но он позволяет цифрам следовать за шестнадцатерично экранированными символами. Это означает, что после шестнадцатерично экранированного идентификатора необходимо включить два пробела для отделения его от следующего идентификатора. Например, лучше использовать строку "\2A 1" вместо \2A 1 с двумя пробелами, так как инструменты форматирования кода могут удалить двойные пробелы. В целом безопаснее использовать кавычки для идентификаторов, требующих экранирования, или использовать строки.

Формальное определение

Связанное правило at-rule @counter-style
Начальное значение n/a (required)
Вычисленное значение как указано

Формальный синтаксис

symbols = 
<symbol>+

<symbol> =
<string> |
<image> |
<custom-ident>

<image> =
<url> |
<gradient>

<url> =
<url()> |
<src()>

<url()> =
url( <string> <url-modifier>* ) |
<url-token>

<src()> =
src( <string> <url-modifier>* )

Примеры

Настройка символов счётчика

В этом примере список значений для описания symbols включает буквы (A, D, E), число в кавычках ("1"), и шестнадцатеричный экранированный идентификатор в кавычках ("\24B7") для символа Ⓑ.

HTML

<ul class="list">
  <li>One</li>
  <li>Two</li>
  <li>Three</li>
  <li>Four</li>
  <li>Five</li>
</ul>

CSS

@counter-style symbols-example {
  system: fixed;
  symbols: A "1" "\24B7" D E;
}

.list {
  list-style: symbols-example;
}

Результат

Спецификации

Спецификация
CSS Counter Styles Уровень 3
# counter-style-symbols

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
symbols
91Не поддерживает <image> как значение для описания symbols.
91Не поддерживает <image> как значение для описания symbols.
33Не поддерживает <image> как значение для описания symbols.
77Не поддерживает <image> как значение для описания symbols.
17
91Не поддерживает <image> как значение для описания symbols.
33Не поддерживает <image> как значение для описания symbols.
64Не поддерживает <image> как значение для описания symbols.
17
16.0Не поддерживает <image> как значение для описания symbols.
91Не поддерживает <image> как значение для описания symbols.

См. также

  • @counter-style описания: system, additive-symbols, negative, prefix, suffix, range, pad, speak-as, fallback
  • Стили списка: list-style, list-style-image, list-style-position
  • symbols() функция
  • <url> тип
  • Модуль CSS counter styles

© 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/symbols

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API