ol标签专用于线性操作流程,如产品使用说明,提供语义化序号以提升可访问性和SEO;应避免div手动编号或ul伪元素模拟,优先用CSS list-style-type或::marker控制样式,嵌套ol需确保子步骤仍为可执行序列。

ol 标签必须用在有明确步骤顺序的场景
产品使用说明本质是线性操作流程,ol 正是为此设计的语义化标签。浏览器和屏幕阅读器会自动识别其序号逻辑,这对可访问性(a11y)和 SEO 都有实际影响。别用 div + 手动编号,也别为了“好看”改用 ul + CSS 伪元素模拟序号——那样会丢失语义,语音朗读时可能读成“项目符号、项目符号、项目符号”。
type 属性控制编号样式,但现代开发中应少用
ol 的 type 属性支持 "1"(数字,默认)、"A"、"a"、"I"、"i",比如说明书里“第一步→第二步”适合默认数字,而“安装→配置→启动”这类阶段标题偶尔用大写字母更清晰。但要注意:
-
type是 HTML4 遗留属性,在 HTML5 中已不推荐;CSS 的list-style-type更可控且不影响语义 - 某些老版本 IE 对
type="I"(大写罗马数字)渲染不一致,比如把I渲染成1 - 若需自定义前缀(如“STEP 1.”),直接用 CSS 的
::marker更稳妥
嵌套 ol 要谨慎:避免语义混乱
说明书里偶尔会出现“步骤 3 下有子步骤”,这时可以嵌套 ol,但必须确保子列表仍是独立、可执行的操作序列。常见错误是把注意事项、补充说明或并列选项塞进子 ol —— 它们不属于“下一步”,该用 ul 或 dl。
正确示例:
htmlq 是一个命令行工具,使用 CSS 选择器从 HTML 中提取内容,相当于 jq 的 HTML 版本。该工具使用 Rust 编写,允许你通过 CSS 选择器将 HTML 管道化,直接从终端提取文本、属性和结构化内容。
<ol>
<li>打开包装盒</li>
<li>连接电源适配器</li>
<li>开机并完成初始设置
<ol>
<li>选择语言</li>
<li>连接 Wi-Fi</li>
<li>登录账户</li>
</ol>
</li>
</ol>
li 里可以放任意内容,但别忽略换行与间距
li 不限于纯文本,可包含 p、img、code 甚至小段 ul(比如某一步骤需勾选多个选项)。但要注意视觉节奏:
- 每个
li默认无 margin-bottom,长说明容易挤在一起;建议统一加margin-bottom: 1em或用gap控制ol - 图片若放在
li内,记得设display: block防止基线对齐错位 - 避免在
li开头强行插入换行——那是结构混乱的信号,应该靠 CSS 控制
真正难处理的,其实是多语言说明书里序号本地化(比如阿拉伯语从右往左,序号位置要变),这得靠 dir 属性和 CSS 的 counter-style 配合,不是加个 type 就能解决的。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










