counter-set

Baseline 2023

Newly available

Since December 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

**counter-set** CSS 属性将 CSS 计数器 设置为元素上的给定值。

如果计数器不存在，则 counter-set 属性会为列表中每个以空格分隔的计数器和值对创建一个新的计数器。但是，建议使用 counter-reset CSS 属性来创建新的计数器。

如果列表中某个命名计数器缺少值，则该计数器的值将设置为 0。

试试看

**注意：**可以使用 counter-increment CSS 属性增加或减少计数器的值。

语法

css
/* Set "my-counter" to 0 */
counter-set: my-counter;

/* Set "my-counter" to -1 */
counter-set: my-counter -1;

/* Set "counter1" to 1, and "counter2" to 4 */
counter-set: counter1 1 counter2 4;

/* Cancel any counter that could have been set in less specific rules */
counter-set: none;

/* Global values */
counter-set: inherit;
counter-set: initial;
counter-set: revert;
counter-set: revert-layer;
counter-set: unset;

counter-set 属性指定为以下两种情况之一：

  • 一个 <custom-ident>，命名计数器，可选地后跟一个 <integer>。您可以指定任意数量的计数器进行重置，每个名称或名称-数字对之间用空格分隔。
  • 关键字值 none。

值

<custom-ident>

要设置的计数器的名称。

<integer>

将计数器设置为每个元素出现时的值。如果未指定，则默认为 0。如果元素上当前不存在给定名称的计数器，则元素将创建具有给定名称的新的计数器，其起始值为 0（尽管它可能会立即将该值设置为或增加到其他值）。

none

不执行任何计数器设置。这可以用来覆盖在较不具体的规则中定义的 counter-set。

正式定义

初始值none
应用于所有元素
继承否
计算值如指定
动画类型按计算值类型

正式语法

counter-set = 
  [ <counter-name> <integer>? ]+  |
  none

示例

设置命名计数器

css
h1 {
  counter-set: chapter section 1 page;
  /* Sets the chapter and page counters to 0,
     and the section counter to 1 */
}

规范

规范
CSS Lists and Counters Module Level 3
# propdef-counter-set

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参见