可访问性

2023 年 5 月 10 日

承诺

Grafana Labs 致力于改进我们的图形用户界面和整体用户体验，以便我们的产品对残障人士和所有人来说都易于使用和访问。 

符合性状态

Web 内容可访问性指南 (WCAG) 定义了设计师和开发人员为提高残障人士可访问性所需遵循的要求。它定义了三个符合性级别：A 级、AA 级和 AAA 级。
Grafana 部分符合 WCAG 2.1 AA 级，并致力于未来完全达到此状态。部分符合意味着部分内容未完全符合可访问性标准。

支持可访问性所采取的步骤

Grafana Labs 采取以下措施确保 Grafana 的可访问性：

  • 由一群可访问性大使倡导，确保开发人员具备可访问性知识和技能
  • 在编写可访问组件时提供最佳实践和建议
  • 通过内部可访问性工作组推动持续改进并确保责任落实
  • 为员工提供可访问性培训
  • 使用自动化工具对正在开发的功能进行可访问性测试
  • 与残障人士参与者进行可用性测试

技术规范

Grafana 的可访问性依赖于以下技术，以与您的计算机上安装的特定组合的 Web 浏览器以及任何辅助技术或插件一起工作：

  • HTML
  • WAI-ARIA
  • CSS
  • JavaScript

这些技术是用于符合所使用的可访问性标准的。

限制和替代方案

虽然 Grafana Labs 致力于改进 Grafana 的可访问性，但我们知道当前存在一些限制。如果您想提出下面列表中没有的问题，请在 GitHub 上提交问题。请给新问题添加一个 type:accessibility 标签。 

截至本文撰写时，主要的限制在于以下领域：

  • 图表：我们计划为创建的图表提供对色盲友好的替代调色板和模式，以及一种轻松切换到图表背后的数据表的方式。
  • 颜色对比度：现代 Grafana 界面通常没有颜色对比度问题。但是，较旧的代码可能低于推荐的对比度水平。随着我们持续更新代码，这个问题将自然消除。
  • 键盘支持：Grafana 的某些部分无法完全通过键盘访问。我们计划改进键盘支持，提供跳到内容、避免键盘陷阱以及始终显示焦点指示器的可能性。 

要查看具体问题，请查看我们在 GitHub 上带有“type/accessibility”标签的问题。

评估和测试环境

Grafana Labs 通过以下方法评估了 Grafana 的可访问性：

  • 自我评估：内容由我们自己的组织或内容开发者进行评估。我们定期对所有主要浏览器和操作系统进行手动测试，此外还测试了以下屏幕阅读器： 
    • 在 MacOS 上使用 Safari、Chrome 和 Edge 的 VoiceOver
    • 在 Windows 上使用 Chrome 和 Firefox 的 NVDA
    • 在 Linux 上的 Orca
  • 自动化评估：我们使用 pa11y 测试我们的主要工作流程和用例。
  • 可访问性 Linting：我们正在努力在开发过程中集成 a11y linting，以确保在早期阶段就考虑可访问性。我们在 Github 上有一个持续跟踪此进展的问题（https://github.com/grafana/grafana/issues/37782）。

反馈

我们欢迎您就 Grafana 的可访问性提供反馈。如果您在使用 Grafana 时遇到可访问性障碍，请在 GitHub 上提交问题 或发送电子邮件至 info@grafana.com 告知我们。