HTML5语义标签自带隐式ARIA角色,无需额外role属性;多个必须用aria-label区分;仅当无原生标签可用时才显式添加role。

直接用 、、、、 这五个标签,就能让屏幕阅读器用户一键跳转到对应区域——不需要加 role,加了反而可能出错。
为什么不用写 role="navigation" 却能被识别为导航?
因为浏览器和辅助技术对这些 HTML5 标签做了隐式角色映射: 默认就是 role="navigation", 就是 role="main", 是 role="contentinfo"。这不是“约定俗成”,而是 W3C 规范强制要求的行为。
常见错误现象:
- 给
再写role="navigation"—— Chrome DevTools 的 Accessibility 面板会显示 “Computed Role: navigation”,但 Lighthouse 可能报landmark-is-unique或干扰旧版 NVDA 解析 - 把
套在里 —— 外层role会覆盖内层语义,导致地标丢失- 用
替代后又加role="navigation"—— 这违反 ARIA 第一条规则:“有原生语义时,别重写”多个 nav 怎么区分?必须用 aria-label
一个页面可以有多个
,但所有默认都叫“导航区域”。屏幕阅读器用户听到的是一串无意义的“导航、导航、导航”,根本分不清哪个是顶部菜单、哪个是页脚链接、哪个是面包屑。解决方案只有一种:用
aria-label提供唯一上下文。
DeepBI DHTML 页面生成器下载生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
-
→ 用于顶部横向菜单 -
→ 放在内的链接集合 -
→ 文章页右侧 TOC(目录)
注意:
aria-labelledby也可用,但必须确保引用的 ID 对应一个可见且语义明确的文本节点;aria-label更轻量、更可控,优先选它。什么时候才需要显式写 role 属性?
只有两种真实场景值得破例:
- 用 实现搜索框容器,且无法改造成
—— 此时必须加role="search",否则不会出现在地标列表中- 老项目无法重构语义结构,比如仍用
- 老项目无法重构语义结构,比如仍用
- 用
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










