The symbols() CSS function enables defining counter styles inline, directly as a value of properties such as list-style, providing a less powerful but simpler alternative to the @counter-style method of defining a counter style.
Unlike @counter-style, which defines a reusable counter style, symbols() is anonymous (i.e., it can only be used once). This function accepts strings and images as values. In comparison, the @counter-style's symbols descriptor also accepts identifiers.
Syntax
symbols() = symbols( <symbols-type>? [ <string> | <image> ]+ );
<symbols-type> can be one of the following:
cyclic: The system cycles through the given values in the order of their definition, and returns to the start when it reaches the end.numeric: The system interprets the given values as the successive units of a place-value numbering system.alphabetic: The system interprets the given values as the digits of an alphabetic numbering system, like a place-value numbering system but without0.symbolic: The system cycles through the values, printing them an additional time at each cycle (one time for the first cycle, two times for the second, etc.).fixed: The system cycles through the given values once, then falls back to Arabic numerals.
Formal syntax
Examples
HTML
<ol>
<li>One</li>
<li>Two</li>
<li>Three</li>
<li>Four</li>
<li>Five</li>
</ol>
CSS
ol {
list-style: symbols(cyclic "*" "†" "‡");
}
Result
Examples
Specifications
Browser compatibility
See also
- @counter-style descriptors: @counter-style/system, @counter-style/symbols, @counter-style/additive-symbols, @counter-style/prefix, @counter-style/suffix, @counter-style/range, @counter-style/pad, @counter-style/speak-as, @counter-style/fallback
- List style properties: list-style, list-style-type
- CSS counter styles module
- CSS lists and counters module
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
