lang属性必须写在标签上并严格遵循bcp 47标准(如zh-cn),data-*用于合法存储业务数据,tabindex需按语义区分0与-1,hidden需配合aria-hidden="true"确保完全隐藏。

lang 属性必须写在 标签上,且值要精确匹配语言变体
浏览器和辅助技术依赖 lang 判断发音、断字、翻译策略。写错位置或值不规范,会导致屏幕阅读器读错中文声调、Google 翻译把简体当繁体处理。
-
lang="zh"或lang="cn"是无效值,应严格使用 BCP 47 标准,如lang="zh-CN"(大陆简体)、lang="zh-TW"(台湾繁体) - 不能只在某个
<p></p>上加lang就以为覆盖全页——根元素的lang是默认继承源 - 多语言站点需用 JS 动态更新
document.documentElement.lang,静态写死会失效
data-* 属性是唯一合法的自定义数据载体,别塞进 class 或 id
把业务数据(如用户 ID、状态码、埋点标识)硬编码进 class="user-123 active",等于把逻辑耦合进样式层,后续改样式或 JS 提取时极易断裂。
-
data-user-id="123"、data-track="homepage-banner"才是正确写法,JS 可直接用element.dataset.userId读取 -
data-后只能跟小写字母、数字、短横线,不能有下划线或大写字母(data_user_id无效) - 避免过度使用:一个元素堆 5 个
data-属性,往往说明结构该拆分或状态该由 JS 管理
tabindex 不是“让元素可聚焦”的万能开关,负值和 0 值行为完全不同
乱设 tabindex="0" 会让非交互元素(比如 <div>)进入 Tab 键流,破坏键盘导航节奏;而 <code>tabindex="-1" 只支持 JS 聚焦,不进 Tab 流——两者语义和无障碍影响截然不同。
-
tabindex="0":元素按 DOM 顺序加入 Tab 流,适合需要键盘操作的自定义控件(如手写的<select></select>替代品) -
tabindex="-1":仅支持.focus()调用,常用于模态框打开后手动聚焦首个可操作项 - 永远不要用正整数(如
tabindex="2"),它强制重排 Tab 顺序,导致不可预测的焦点跳跃,WCAG 明确不推荐
hidden 属性比 display: none 更语义化,但不等于完全移除可访问性
hidden 是 HTML 原生布尔属性,告诉浏览器“这个元素当前不参与渲染也不参与交互”,但它仍存在于 DOM 中,且部分屏幕阅读器(如 NVDA)默认仍会读出 hidden 元素里的文本——这点常被忽略。
- 若需彻底隐藏(包括对辅助技术),应组合使用:
hidden aria-hidden="true" -
hidden不影响 CSS 选择器权重,[hidden] { display: none; }是它的默认样式,但你可以覆盖它(不建议) - 与
display: none的关键区别:hidden元素不占布局空间,且不触发重排;但 JS 仍可读取其offsetHeight(返回 0),而display: none下某些旧版 IE 会返回undefined
真正难的不是记住哪些属性可用,而是判断某段业务逻辑该用 data- 存、用 aria- 描述,还是该重构为语义化标签。全局属性不是补丁,是 HTML 语义骨架的延伸接口。











