多级标题必须严格按语义层级嵌套:一个页面仅一个h1作为核心主题锚点,置于主内容区顶部;h2–h6逐级嵌套、不可跳级或倒序;层级建议≤3层;禁用div模拟标题,样式与语义须分离。

多级标题排列必须严格遵循语义层级和 DOM 结构规则,不是按视觉大小排,而是按内容从属关系嵌套。
一个页面只用一个 h1,且必须准确表达整页核心主题
h1 是页面的“唯一锚点”,应出现在主内容区最上方。比如文章页写文章标题本身,产品页写具体产品名称,首页写“品牌名 + 主定位”。轮播图、侧边栏、推荐卡片里塞
新品上市
是典型错误——它会让搜索引擎和读屏器无法识别主次。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 服务端首屏 HTML 必须包含有效 h1,不能等 JS 加载完再动态插入
- SPA 路由切换时,要同步更新 h1 文本,不能靠 CSS 隐藏旧 h1 显示新 h1
- 组件库中的卡片、弹窗、列表项禁止使用 h1,统一用 h2 或通过 aria-labelledby 关联语义
h2 到 h6 必须逐级嵌套,禁止跳级或倒序
每个标题都必须有明确的上一级父级。h2 是 h1 的直接子模块,h3 必须隶属于某个 h2,依此类推。浏览器和辅助技术依赖这种线性结构生成大纲,跳级会导致逻辑断裂。
- 合法结构:h1 → h2 → h3,或 h1 → h2 → h2(同级并列)
- 非法结构:h1 → h3(跳过 h2)、h2 → h4(跳过 h3)、h3 → h1(倒序)
- 富文本编辑器输出的 #### 若前面没 ###,需在渲染层自动补逻辑占位,否则结构断裂
层级深度建议控制在三层以内,h4–h6 不宜滥用
h4 及以下仅在必要时出现,比如政策文件条款、API 参数说明等极度细分场景。多数内容型页面用到 h3 就足够。嵌套过深(如 h2 → h3 → h4 → h5)会增加认知负荷,尤其对认知障碍用户不友好。
- 真需要更细颗粒度?优先考虑
、或带语义 class 的,而不是硬塞 h5/h6- h6 不是“小号文字”,而是语义上的“最末级标题”,别拿它当备注、提示或强调句用
- 标题文字要简洁主动,避免“关于……的相关说明”这类模糊表达
样式与语义必须彻底分离
可以用 CSS 把 h3 设得比 h1 还大,只要 DOM 层级正确,机器仍能读对结构。但绝不能用
或模拟标题——语义为零,SEO 和无障碍全失效。- 起步建议重置默认样式:
h1, h2, h3, h4, h5, h6 { margin: 0; font-weight: normal; line-height: 1.2; } - 禁用
v-html或dangerouslySetInnerHTML拼接标题标签,拼错一个数字,整个大纲就垮了 - 动态渲染时 props.level 必须校验为 1–6 的整数,非合规值统一 fallback 到 h2(比 h1 更稳妥)
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










