nav标签必须包裹可跳转的链接集合,单独包裹按钮、图标或纯文本会导致语义失效;main只能出现一次且不可嵌套;h1全页唯一并须位于main内,标题层级须严格递进。
单独用 <nav> 包一个按钮、一个图标或纯文本,屏幕阅读器会识别为 role="navigation",但内部无跳转能力,直接忽略导航意图。它不是“有导航样式的容器”,而是“可跳转的链接组”专用标记。
常见错误现象:
<nav><button>菜单</button></nav> —— 没有 href 或可聚焦交互逻辑,读屏不播报为导航项<nav>首页 关于我们</nav> —— 缺少 <ul><li> 结构,NVDA 会连读成“首页关于我们”,无法区分项数与顺序<nav> 未加 aria-label,VoiceOver 在“区域跳转”模式下只报“导航”,无法区分主导航/页脚链接/面包屑正确做法:
<nav> 至少含一个有效 <a href> 或带 tabindex="0" + role="link" 的可聚焦元素<ul><li> 套链接,不可用 <div> 模拟列表(即使加 role="list" 兼容性也差)<nav> 时,必须配 aria-label,如 <nav aria-label="主导航"> 和 <nav aria-label="文章内目录">
<main> 表示页面唯一主体内容区,浏览器和读屏软件靠它提供“跳转到主要内容”快捷指令。一旦重复或嵌套,辅助技术会丢弃该区域,用户被迫线性听完整页。
立即学习“前端免费学习笔记(深入)”;
典型误用场景:
<section> 或 <article> 内再写一个 <main> —— 违反规范,部分读屏直接跳过整块<header>,中间用 <main>,底部又塞一个 <main> —— 第二个 <main> 被忽略,页脚内容被当成正文一部分朗读<main> 但没设 aria-hidden="true",导致视觉不可见但语音仍播报实操建议:
<main>,且直接位于 <body> 下(允许被 <header>/<footer> 同级并列)<section> 或 <article> 分组,而非多个 <main>
<main> —— React/Vue 组件复用容易踩这个坑屏幕阅读器依赖 <h1>–<h6> 构建文档大纲(outline),跳级或乱序会导致“子章节突然变成父章节”,用户无法建立稳定认知路径。
常见错误现象:
<h2> 开始,没有 <h1> —— 读屏默认把第一个 <h2> 当作主标题,后续 <h3> 被理解为同级而非子级<main> 外写了三个 <h1>(比如 logo、banner 标题、侧边栏标题)—— 大纲崩溃,NVDA 的“标题导航”模式失效<h3> 写小标题,但其所属 <section> 没有 <h2> 开头 —— 读屏认为这是独立顶级区块,而非嵌套结构关键约束:
<h1>,代表页面核心主题(如文章标题、产品名称)<section> 或 <article> 应以 <h2> 起始(若整体已用 <h1>)position: absolute; clip: rect(1px, 1px, 1px, 1px);,禁用 display: none 或 visibility: hidden
原生语义标签(如 <nav>、<main>、<button>)自带角色(role)、名称(name)和状态(state)。乱加 ARIA 属性反而覆盖默认行为,导致读屏误解或静默失败。
容易踩的坑:
<label for="xxx"> 的 <input> 再加 aria-labelledby —— 读屏重复播报两次role="dialog" + aria-modal="true",仅靠 aria-hidden="true" 关闭背景 —— 键盘焦点仍可进入背景内容aria-current="true" 标识当前页 —— 不是合法值,NVDA 忽略,应始终用 aria-current="page"
原则:
display: none
aria-expanded 和 aria-current,不能只改 class<h1>、<main> 嵌套、或 <nav> 里没链接。这些地方机器不会报错,但人会因此卡在页面里。