@counter-style

在此页

句法
形式句法
范例
规范
浏览器兼容性
另请参阅
相关话题

@counter-style CSS at-rule lets you define counter styles that are not part of the predefined set of styles. A @counter-style rule defines how to convert a counter value into a string representation.

@counter-style thumbs {
  system: cyclic;
  symbols: "\1F44D";
  suffix: " ";
}
ul {
  list-style: thumbs;
}

The initial version of CSS defined a set of useful counter styles. However, although more styles were added to this set of predefined styles over the years, this system proved too restrictive to fulfill the needs of worldwide typography. The @counter-style at-rule addresses this shortcoming in an open-ended manner, by allowing authors to define their own counter styles when the pre-defined styles aren't fitting their needs.

句法

Descriptors

每个 @counter-style is identified by a name and has a set of descriptors.

system

negative

prefix

suffix

range

pad

fallback

symbols

Specifies the symbols that are to be used for the marker representations. Symbols can contain string, images or custom identifiers. How the symbols are used to construct the marker representation is up to the algorithm specified in the system descriptor. For example, if the system specified is fixed, then each of the N symbols specified in the descriptor will be used to represent the first N counter symbols. Once the specified set of symbols have exhausted, the fallback style will be used for the rest of the list.

The below


@counter-style

rule uses images instead of character symbols. Image values for symbols is currently an 'at risk' feature, and is not implemented in any browser.

@counter-style winners-list {
  system: fixed;
  symbols: url(gold-medal.svg) url(silver-medal.svg) url(bronze-medal.svg);
  suffix: " ";
}

additive-symbols: While the symbols specified in the symbols descriptor is used for constructing marker representation by most algorithms, some systems such as 'additive' rely on additive tuples described in this descriptor. Each additive tuple consists of a counter symbol and a non negative integer weight. The additive tuples must be specified in the descending order of their weights.

speak-as

形式句法

@counter-style <counter-style-name> {
  [ system: <counter-system>; ] ||
  [ symbols: <counter-symbols>; ] ||
  [ additive-symbols: <additive-symbols>; ] ||
  [ negative: <negative-symbol>; ] ||
  [ prefix: <prefix>; ] ||
  [ suffix: <suffix>; ] ||
  [ range: <range>; ] ||
  [ pad: <padding>; ] ||
  [ speak-as: <speak-as>; ] ||
  [ fallback: <counter-style-name>; ]
}where 
<counter-style-name> = <custom-ident>

范例

Specifying symbols with counter-style

@counter-style circled-alpha {
  system: fixed;
  symbols: Ⓐ Ⓑ Ⓒ Ⓓ Ⓔ Ⓕ Ⓖ Ⓗ Ⓘ Ⓙ Ⓚ Ⓛ Ⓜ Ⓝ Ⓞ Ⓟ Ⓠ Ⓡ Ⓢ Ⓣ Ⓤ Ⓥ Ⓦ Ⓧ Ⓨ Ⓩ;
  suffix: " ";
}

The above counter style rule can be applied to lists like this:

.items {
  list-style: circled-alpha;
}

Which will produce lists like this:

Ⓐ One
Ⓑ Two
Ⓒ Three
Ⓓ Four
Ⓔ FIve
...
...
Ⓨ Twenty Five
Ⓩ Twenty Six
27 Twenty Seven
28 Twenty Eight
29 Twenty Nine
30 Thirty

See more examples on the demo page .

规范

规范	状态	注释
CSS Counter Styles Level 3 The definition of 'counter-style' in that specification.	候选推荐	初始定义。

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`@counter-style`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`additive-symbols`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`fallback`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`negative`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`pad`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`prefix`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`range`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`speak-as`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`suffix`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`symbols`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No
`system`	Chrome 不支持 No	Edge 不支持 No	Firefox 完整支持 33	IE 不支持 No	Opera 不支持 No	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 完整支持 33	Opera Android 不支持 No	Safari iOS 不支持 No	Samsung Internet Android 不支持 No

图例

完整支持
不支持

Quantum CSS notes

Gecko allowed none as a value of the system and fallback descriptors of @counter-style , which as per spec should result in an invalid at-rule. Firefox's new parallel CSS engine (also known as Quantum CSS or Stylo , released in Firefox 57) fixed this ( bug 1377414 ).

另请参阅

list-style , list-style-image , list-style-position , list-style-type
symbols() , the functional notation creating anonymous counter styles.
CSS counter() and counters() 函数
Counter style demo ( code )

元数据

最后修改： Aug 3, 2020

在此页

句法