合法必须严格嵌套:内仅含,每个须显式闭合且内容包裹其中;浏览器自动编号的前提是结构合规、标签闭合、语义正确。

ol列表不是“加个数字”那么简单,用错标签或漏写闭合,后续 JS 选不到节点、屏幕阅读器读错顺序、CSS 样式失效都是常态。必须从第一行就写对结构。
怎么写一个合法的 ol?只用三行代码
浏览器自动编号的前提是:语法合规、嵌套干净、标签闭合。别信“HTML5 容错”——那只是解析器兜底,不是你该依赖的逻辑。
-
ol必须包裹在内,不能直接放在或文档根下 - 每个列表项必须用
li,且li只能出现在ol或ul里,不能裸奔 -
li必须显式闭合( ),哪怕内容只有一行文本
正确模板:
<ol> <li>第一步:打开冰箱门</li> <li>第二步:把大象装进去</li> <li>第三步:关上冰箱门</li> </ol>
type 和 start 属性能不能混用?
能,但不推荐。它们是 HTML4 遗留属性,现代项目应优先用 CSS 控制编号样式,理由很实际:
-
type="A"只支持 5 种值:1/A/a/I/i,没法加前缀(如 “Step 1.”)或 emoji -
start="5"在 IE 和部分 SSR 框架中行为不一致,比如 Vue SFC 中可能被忽略 - 如果同时写了
type="a"和list-style-type: lower-roman,CSS 会覆盖 HTML 属性,造成预期外结果
建议统一走 CSS 路线:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
ol {
list-style-type: lower-alpha;
}
ol.start-at-3 {
counter-reset: section 2;
}
ol.start-at-3 li::before {
content: "Step " counter(section) ". ";
counter-increment: section;
}
为什么 ol 里的文字缩进不对?
这不是编号问题,是默认 padding-left 被重置或冲突导致的。几乎所有 CSS 重置库(如 normalize.css、tailwind 的 base)都会清掉 ol 和 ul 的原生缩进。
- 先检查是否全局设置了
ol, ul { padding-left: 0; }—— 这是最常见原因 - 别用
list-style-position: inside强行“对齐”,它会让换行文本首行缩进异常,尤其在响应式断行时 - 稳妥做法:保留默认
padding-left,用margin-left微调整体位置;若需彻底自定义,用list-style: none+li::before
嵌套 ol 时最容易崩在哪?
三层以上嵌套基本等于放弃可维护性。真正出问题的地方往往藏在语义和 DOM 结构里:
- 子
ol必须完整写在父li内部,而不是跟在li后面——否则浏览器会把它当成父级的下一个兄弟节点 - 嵌套后屏幕阅读器可能连续读出“第1项,第1.1项,第1.2项”,但用户听不出层级跳转,更适合改用
dl或details包裹解释性内容 -
document.querySelectorAll('li')会平铺所有层级的li,如果业务逻辑依赖“第几层”,得靠closest('ol')手动判断深度
复杂流程别硬套嵌套 ol,先想清楚:这是步骤的子步骤,还是某个步骤的补充说明?后者往往不该用 ol。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










