role="none" 是 WAI-ARIA 1.1 正式引入的标准角色，与 role="presentation" 完全等效，用于移除元素的默认可访问性语义；SonarCloud 的误报源于未上下文感知的静态检查，而非该值本身无效。
`role="none"` 是 WAI-ARIA 1.1 正式引入的标准角色，与 `role="presentation"` 完全等效，用于移除元素的默认可访问性语义；SonarCloud 的误报源于未上下文感知的静态检查，而非该值本身无效。
在现代 Web 可访问性实践中，role="none" 是一个完全合法、非抽象、且被主流浏览器和辅助技术广泛支持的 ARIA 角色。它于 WAI-ARIA 1.1 规范 中明确定义，核心语义是：显式剥离该元素的隐含可访问性角色与属性，使其不向辅助技术暴露任何语义信息——这与 role="presentation" 行为完全一致。
之所以引入 role="none"，正是为了解决开发者对 role="presentation" 的常见误解（例如误以为它仅影响视觉呈现）。二者可互换使用，但 none 语义更直白、意图更清晰：
<!-- ✅ 两者功能完全等价，均移除 <li> 的列表项语义 -->
⚠️ 关键前提：合法性取决于使用上下文role="none" 本身永远有效，但其是否合理需结合父容器语义判断。例如：
-
在标准语义化列表中滥用：
<!-- ❌ 不推荐：破坏原生 list/listitem 语义，无替代方案时会损害可访问性 -->
- 普通列表项
-
在自定义组件中正确应用（典型场景）：
<!-- ✅ 合理：配合 <ul role="menu"> 使用，<li> 作为容器，语义由子元素 <a role="menuitem"> 承载 -->
当前 SonarCloud、SonarLint 等工具的 ARIA 检查仍属基础规则引擎，缺乏对 DOM 上下文（如父级 role="menu"）的深度分析能力，因此将 <li role="none"> 一律标记为“无效角色”属于典型的误报（false positive）。这不是规范问题，而是检测逻辑缺陷。
✅ 最佳实践建议：
- 优先使用
role="none"（比presentation更语义明确）； - 始终确保被移除语义的元素，其可访问性职责已由其他元素（如带
menuitem、button等角色的子节点）完整承接； - 若团队依赖 Sonar 检查，建议向 SonarSource 社区 提交该误报案例，推动规则优化；
- 可通过
<!-- sonar-ignore -->短期抑制误报（需附注说明），但不应因此放弃正确使用role="none"。
总之，role="none" 不仅合法，更是构建健壮、语义清晰的自定义控件（如导航菜单、选项卡栏）的关键工具——请放心使用，以规范为准，而非静态扫描器的片面判断。
