功能

Editoria11y 的核心检测项可识别 50 余种常见内容无障碍问题,涵盖影响可读性的设计决策、削弱屏幕阅读器效果的错误,以及降低 SEO 的问题。

扩展插件另提供约 40 项针对开发者和设计师的额外检测,包括自定义检测项和各类全站质量保证工具。

内容检测聚焦于网站移交给内容作者之后出现的问题。网站在上线前需借助手动审计工具、键盘和屏幕阅读器进行测试,但即便是第一天无障碍性最优的网站,随着编辑不断引入新问题,质量也往往会逐渐下滑。

Editoria11y 在无障碍工具中脱颖而出的关键在于:其检测在浏览器中实时运行,贯穿作者编辑和预览内容的全过程。作者更容易对即时的内联反馈作出响应——注意到提示并加以修正——而不是专门去访问仪表板或手动运行检查。

作者使用体验

Editoria11y 工具栏截图,显示 4 个错误。

作者在编辑内容时可看到 Editoria11y 工具栏。检测到问题时,工具栏会变为黄色或红色,并显示问题数量。点击数字可跳转到第一个提示并展开其说明气泡。

提示说明某链接仅命名为

提示以内联方式呈现,包含错误的通俗描述、修正建议,以及该问题的重要性说明。

页面上叠加显示的标题大纲可视化工具

工具栏还提供用于手动检查的附加工具,包括标题大纲和替代文本可视化工具,以及可读性评分。

网站管理员控制

检查器的所有可见方面均可自定义。通过参数和事件,可以移除检测项、重写提示、插入自定义检测项并设置自定义主题。

Drupal 和 WordPress 插件提供额外功能,例如同步忽略操作、全站仪表板和 CSV 报告导出。

报告仪表板,显示近期问题及问题最多的页面。
Drupal 仪表板,包含问题、存在问题的页面及忽略记录的可筛选列表。

检测项

Editoria11y 的检测项致力于从人性化角度而非纯技术标准出发,改善所有用户的网络体验。核心检测项旨在帮助达到网络内容无障碍指南(WCAG 2.2 AA)的要求,其他检测项则参考了认知和学习障碍无障碍工作组的成果,以及通用可用性和设计最佳实践。

网站管理员可关闭单项检测。

图片替代文本

  • 图片缺少 alt 属性
  • 替代文本是文件名
  • 替代文本是占位符("TBD")
  • 替代文本是无法朗读的符号
  • 替代文本含冗余词语("图片显示…")
  • 替代文本过长
  • 装饰性图片可能有实际价值
  • 轮播图被标记为装饰性
  • 有说明文字的图片缺少替代文本
  • 替代文本与说明文字重复

链接图片

  • 链接图片没有替代文本
  • 链接图片替代文本是 URL 或文件名
  • 链接图片替代文本是占位符
  • 链接图片替代文本是无法朗读的符号
  • 链接图片替代文本描述的是图片而非链接
  • 链接图片替代文本含冗余词语
  • 链接图片替代文本过长
  • 含文字的链接中的图片缺少 alt 属性

嵌入媒体

  • 视频需要字幕
  • 音频需要文字稿
  • 数据可视化需要无障碍替代方案
  • 框架缺少标题
  • 框架被排除在键盘导航之外
  • 框架内容需要手动无障碍检查
  • 链接文档可能不支持屏幕阅读器访问
  • PDF 缺少无障碍替代方案
  • 嵌套的交互式布局组件

有意义的链接

  • 空链接
  • 链接文本是 URL
  • 链接文本仅为 DOI 号码
  • 链接文本写的是"点击此处"
  • 链接文本仅为通用词语("阅读更多")
  • 不同链接共用相同文本
  • 链接图标或图片没有文字替代
  • 链接在未提示的情况下打开新标签页
  • 链接在未提示的情况下指向文件
  • 链接文本仅为符号或表情符号
  • 对视力正常用户隐藏的有意义链接文本
  • 冗余的链接提示
  • 页内锚点链接失效
  • 重复的 ID 属性
  • 链接可能指向开发环境

标题层级

  • 页面缺少一级标题
  • 第一个标题是子标题
  • 标题跳过层级
  • 标题为空
  • 用作标题的图片需要替代文本
  • 标题过长
  • 加粗段落可能应为标题
  • 短引用块可能应为标题

文本可读性

  • 过多大写文本
  • 大段粗体或斜体文本
  • 文本字号过小
  • 非链接文本带下划线
  • 文本两端对齐
  • 下标或上标被误用作格式
  • 用字符或符号模拟列表
  • 列表项位于列表之外

颜色对比度

  • 文本对比度不足
  • 文本对比度需要手动检查
  • 图标或图形对比度不足
  • 图标或图形对比度需要手动检查
  • 输入框文本对比度不足
  • 占位符文本对比度不足

表格

  • 表格缺少标题行或标题列
  • 表格标题单元格为空
  • 在表格内使用了内容标题

表单与交互元素

  • 按钮没有无障碍标签
  • 按钮具有无效的 ARIA 标签
  • 按钮标签包含"按钮"一词
  • 可见标签与无障碍名称不匹配
  • 输入框没有关联标签
  • 输入框仅使用不可见标签
  • 输入框仅以占位符作为标签
  • 重置按钮可能导致意外数据丢失
  • 元素对屏幕阅读器隐藏但仍可通过键盘聚焦
  • 正数 tabindex 破坏阅读和 Tab 键顺序

页面元数据

  • 页面标题缺失
  • 未声明页面语言
  • 视口设置阻止文本缩放
  • 页面自动刷新

CSA 功能

Editoria11y 以独特方式推动无障碍建设。其工具能有效帮助非技术背景的作者准备出残障网络用户同样可以无障碍享用的内容。我们视此为一项公益事业,因此Editoria11y 将始终免费使用

然而,Editoria11y 的开发和支持并非免费。

CSA 填补了这一空白:项目成员资助 Editoria11y 库、CMS 插件及 CSA 套件的开发——CSA 套件是一套快速成长的开源质量保证工具集,以远低于商业产品的价格提供同等功能。 Drupal 版 CSA 套件目前在测试阶段免费提供,WordPress 版将于 2026 年第三季度推出。

站点爬取进行中
CSA 爬虫正在刷新仪表板。

检测项与工具

  • 开发者、可读性和对比度检测。
  • 面向开发者和内容创作者的基于角色的分离配置。
  • 自定义检测项构建工具。
  • 一键全站忽略。
  • 仪表板维护工具与爬虫。
检测提示气泡中的颜色选择器

社区权益

  • 优先支持。
  • 对项目路线图有加权影响力。
  • 自动获取路线图上的新功能。
  • 直接设置协助(视会员等级而定)。
  • 公开支持者致谢(视等级/按需申请,条款适用)。

量力而为的授权模式

测试期结束后,CSA 套件将通过量力而为的贡献模式提供。Editoria11y 核心(包括库和插件)将继续免费提供。

查看授权选项与替代方案

CSA 赞助项目

进行中

2026 年第二季度:启动 Editoria11y CSA 社区

待完成工作:

  • 建立财务实体以处理订阅和赞助款项。
  • 搭建授权系统。
2026 年第二季度:自定义规则构建器
  1. Drupal 版已完成。
  2. 待办:将构建器移植到 WordPress。
2026 年第三季度:将 3.x 库移植到 WordPress
  1. 创建含社区支持功能的 CSA 子模块
    • 创建仪表板维护工具,用于清除过期结果并重新爬取现有内容。
    • 支持将特定检测项标记为全站通过,而非仅限单个页面。
    • 支持分离配置,为开发者和内容编辑提供独立的设置和检测项。

近期完成

2026 年第一季度:库 3.x 重写
  • 合并 Editoria11y 和 Sa11y 规则集。自分叉以来,Sa11y 新增了约 50 项检测并引入了 ESM 工具链,Editoria11y 则实施了性能优化并增加了支持实时检测的参数。Sa11y 4.2.2 与 Editoria11y 3.0.0 将开启两者的共同未来。
  • 新增"分离配置"支持,允许为开发者和内容创作者提供独立规则集。
  • 新增中文、丹麦语、荷兰语、德语、希腊语、匈牙利语、意大利语、日语、挪威书面语、波兰语、葡萄牙语(巴西)、葡萄牙语(葡萄牙)、西班牙语、瑞典语和乌克兰语的机器翻译,作为人工精修的模板。
  • 当前状态:编码工作已完成;将在更新文档和演示后发布标签版本。
2026 年第一季度:Drupal 模块 3.x 重写
  1. 扩展仪表板,提供更强大的报告和筛选工具。
  2. 新增中文、丹麦语、荷兰语、德语、希腊语、匈牙利语、意大利语、日语、挪威书面语、波兰语、葡萄牙语(巴西)、葡萄牙语(葡萄牙)、西班牙语、瑞典语和乌克兰语的机器翻译,作为人工精修的模板。
  3. 使 CSV 导出功能可自定义
  4. 创建含社区支持功能的 CSA 子模块
    • 创建仪表板维护工具,用于清除过期结果并重新爬取现有内容。
    • 支持将特定检测项标记为全站通过,而非仅限单个页面。
    • 支持分离配置,为开发者和内容编辑提供独立的设置和检测项。

讨论中

Editoria11y 库论坛中讨论这些想法并投票。

各想法已根据当前社区讨论情况标注难度与优先级估计。

  • 多站点监控仪表板
  • 失效链接检测
  • PDF 扫描
  • 提示气泡代码位置标签
  • 提示气泡页面报告导出
  • 标记词语
  • CLI 开发者工具
  • 书签工具/浏览器插件
  • ACT 规则验证
  • 扩展名称/角色/值验证