counter-set CSS 属性将 CSS 计数器设置为给定值。它会操作现有计数器的值,并且只有在元素上没有给定名称的计数器时才会创建新计数器。
CSS Demo: counter-set
counter-set: none;
counter-set: chapter-count 0;
counter-set: chapter-count;
counter-set: chapter-count 5;
counter-set: chapter-count -5;
<section class="default-example" id="default-example">
<div class="transition-all" id="chapters">
<h1>Alice's Adventures in Wonderland</h1>
<h2>Down the Rabbit-Hole</h2>
<h2 id="example-element">The Pool of Tears</h2>
<h2>A Caucus-Race and a Long Tale</h2>
<h2>The Rabbit Sends in a Little Bill</h2>
</div>
</section>
#default-example {
text-align: left;
counter-set: chapter-count;
}
#example-element {
background-color: #37077c;
color: white;
}
h2 {
counter-increment: chapter-count;
font-size: 1em;
}
h2::before {
content: "Chapter " counter(chapter-count) ": ";
}
[!NOTE] 计数器的值可以通过 counter-increment CSS 属性进行递增或递减。
语法
/* 将 "my-counter" 设置为 0 */
counter-set: my-counter;
/* 将 "my-counter" 设置为 -1 */
counter-set: my-counter -1;
/* 将 "counter1" 设置为 1,将 "counter2" 设置为 4 */
counter-set: counter1 1 counter2 4;
/* 取消在不太具体的规则中可能设置的任何计数器 */
counter-set: none;
/* 全局值 */
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。
- : 不执行计数器设置。这可以用来覆盖在较不具体的规则中定义的
形式定义
形式语法
示例
设置命名计数器
h1 {
counter-set: chapter section 1 page;
/* 将章节和页面计数器设置为 0,
将部分计数器设置为 1 */
}
规范
浏览器兼容性
参见
- 使用 CSS 计数器
- counter-increment
- counter-reset
- @counter-style
- counter 和 counters 函数
- content 属性
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
