counters() 是 content 属性中用于生成嵌套编号的函数,需配合 counter-reset 和 counter-increment 使用,通过指定计数器名和分隔符(如 ".")拼出“1.2.3”式路径,依赖层级结构与独立计数器命名,不支持 IE。

counters() 函数的正确语法和层级嵌套逻辑
counters() 不是独立属性,而是 content 属性中使用的函数,必须配合 counter-reset 和 counter-increment 才能生效。它的核心作用是把嵌套计数器“展开”成用分隔符连接的字符串(比如 "1.2.3"),而不是简单叠加数字。
常见错误是直接写 content: counters(section, ".") 却没在父元素上设置 counter-reset: section,或在子级忘了用 counter-increment: section。它依赖 CSS 的层叠顺序——父元素重置并递增一次,子元素再重置并递增,counters() 才能按深度拼出完整路径。
- 第一层标题需设
counter-reset: section,且自身执行counter-increment: section - 第二层标题需继承父级计数器,并执行自己的
counter-increment: subsection(或复用section,但语义易混淆) -
counters()第二个参数必须是字符串字面量,如"."或"–",不能是变量或计算值
多级编号时 counter-reset 和 counter-increment 的配对陷阱
很多人以为只要所有标题都写 counter-increment: section 就能自动嵌套,结果编号全变成平铺的 1 2 3 4。根本原因是:没有为每一级定义独立的计数器名,或没在恰当位置重置。
正确做法是按 HTML 结构逐级声明—— 用 counter-reset: chapter, 用 counter-reset: section 并 counter-increment: chapter, 则只 counter-increment: section。这样 counters(chapter, ".") 在 中输出 "1",在 中输出 "1.1"。
- 避免全用同一个计数器名(如都叫
section),否则深层元素会覆盖外层值 -
counter-reset必须写在父容器上(如article或section),不是标题自己 - 若某级标题不希望参与编号(如导语
),需显式写counter-increment: none,否则仍会自增
content 中插入编号的实际写法与浏览器兼容性
现代浏览器(Chrome 2+、Firefox 1.5+、Safari 3.1+)都支持 counters(),但 IE 完全不支持。如果项目还需兼容 IE,得用 JS 补位或放弃纯 CSS 方案。
典型写法是结合伪元素:h2::before { content: counters(chapter, ".") ". "; counter-increment: section; }。注意这里 counter-increment 写在 ::before 里,意味着每次生成伪元素就自增一次——这刚好匹配显示需求,但若同时在元素本身也写了 counter-increment,就会重复计数。
-
content值中可拼接字符串:content: "§ " counters(chapter, ".") " — " attr(data-title) - Firefox 对
counters()的分隔符空格处理更严格,建议用"."而非". ",空格留到字符串拼接里加 - 不要在
content中调用未声明的计数器名,否则整个content值会失效(显示为空)
如何让编号跳过某些标题或支持起始值
CSS 计数器本身不提供“跳过”语义,但可通过 counter-increment 的第二个参数控制步长或偏移。例如 counter-increment: chapter 2 会让下一级编号+2;counter-increment: chapter -1 可实现回退(慎用,易混乱)。
起始值靠 counter-reset 的第二个参数实现:counter-reset: chapter 3 表示第一章从 4 开始编号(因为重置后首次 increment 是 +1)。若想第一章显示为 3,就得写 counter-reset: chapter 2。
- 动态起始值无法用纯 CSS 实现(比如根据 URL 参数改变),必须靠 JS 注入
style或类名 - 用
counter-set(CSS Counter Styles Level 3)可更灵活控制,但目前仅 Firefox 和 Safari 技术预览版支持,不建议生产环境使用 - 章节标题若含
display: none,其counter-increment仍会执行——这是容易被忽略的副作用
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











