用途
modern-accessible-html-jsx 用于指导编写干净、现代且高度可访问的 HTML 与 JSX 代码。它把可访问性视为基线要求而非附加增强,目标是通过语义正确、符合标准的标记,让页面在视觉、键盘和屏幕阅读器等多种使用方式下都能正常工作。
主要能力与规范要点
语义优先
- 优先使用语义元素:header、nav、main、section、article、footer。
- 当存在合适的语义元素时,避免使用通用的 div/span。
- 使用正确的标题层级(h1 → h6),不跳过层级。
可访问性
- 始终确保交互元素可通过键盘访问。
- 尽可能优先使用原生 HTML 元素,而不是 ARIA。
- 不要用 ARIA 去修复错误的 HTML 语义。
- 为所有交互控件提供可访问名称:为输入提供标签,必要时使用 aria-label 或可见文本。
表单与输入
- 始终将标签与表单控件关联。
- 优先使用原生校验和输入类型(email、url、number 等)。
- 确保错误信息可访问并能被正确播报。
图片与媒体
- 始终为图片提供有意义的 alt 文本。
- 仅对纯装饰性图片使用空 alt=""。
- 在上下文重要时提供说明文字(figcaption)。
地标与结构
- 通过语义元素隐式使用地标角色。
- 确保存在单一、清晰的 main 区域。
- 面向屏幕阅读器组织内容,而不仅仅是视觉布局。
使用方式
资料未提供具体的安装命令、配置步骤或代码示例。该规范以原则性条款的形式给出,可作为编写 HTML/JSX 时的检查清单或团队约定使用。
适用场景
适用于任何需要编写 HTML 或 JSX 的前端开发场景,尤其是重视可访问性、语义化和标准合规的项目。
限制
资料未说明该规范支持的具体框架、工具链、平台或版本要求,也未提供收费、价格或效果方面的信息。