JupyterLab 可访问性声明#
Jupyter 审计#
本节包含来自不同利益相关者对 Jupyter 产品的审计。
JupyterLab v3.4.5 400% 放大审计 - 于 2022 年进行
JupyterLab v2.2.6 WCAG 2.1 - 于 2020 年进行
Jupyter Notebook WCAG 2.0 - 于 2019 年进行
这些审计中发现的许多问题可以在 JupyterLab 组织内的 GitHub 项目 中跟踪
JupyterLab 可访问性声明#
这是来自 Jupyter 可访问性贡献者的 JupyterLab 3.4.4 的可访问性声明。我们承认还有更近期的 JupyterLab 版本尚未评估。
JupyterLab 的当前状态#
Jupyter 可访问性声明是活文档。本声明最初于 2022 年 5 月 16 日使用 W3C 可访问性声明生成器工具 创建,并由 Jupyter 可访问性贡献者社区添加和编辑。
注意
本声明最后更新于 2022 年 8 月 9 日。
符合性状态#
Web 内容可访问性指南 (WCAG) 为设计师和开发者定义了提高残疾人可访问性的要求。它定义了三个符合性级别:A 级、AA 级和 AAA 级。JupyterLab 不符合 WCAG 2.1 AA 级。不符合意味着内容不符合可访问性标准。
JupyterLab 的可访问性并非孤立存在。JupyterLab 继承了它所构建的许多项目的许多内容,其可访问性符合性可能会影响基于 JupyterLab 或其组件构建的项目。此生态系统的可访问性是相互关联的,因此可能需要在不同级别解决符合性问题,才能对 JupyterLab 产生积极影响。
与浏览器和辅助技术的兼容性#
JupyterLab 旨在与以下内容兼容#
操作系统
Windows
macOS
Linux
iOS
Android
浏览器(移动和桌面)
Firefox
Chrome
Safari
Chromium 浏览器
JupyterLab 与以下内容不兼容#
操作系统
浏览器(移动和桌面)
Internet Explorer
Edge
辅助技术
技术规格#
JupyterLab 的可访问性依赖于以下技术,这些技术与您计算机上安装的特定网页浏览器以及任何辅助技术或插件相结合。
HTML
WAI-ARIA
CSS
JavaScript
这些技术用于符合所使用的可访问性标准。
局限性和替代方案#
尽管我们尽最大努力确保 JupyterLab 的可访问性,但可能存在一些局限性。以下是已知局限性的描述以及潜在的解决方案。如果您发现以下未列出的问题,请与我们联系。
JupyterLab 的已知局限性
**文档**: 由社区编写的文档可能不包含可访问的内容,因为我们无法也不可能审查 JupyterLab 中可以打开和编辑的每个文档。为了支持可访问的文档,我们正在起草可访问文档内容的指南,重点关注 Jupyter 笔记本。请将问题报告给作者,并在 jupyter/accessibility 上创建一个问题,描述问题和您期望的行为,以便我们将其整合到我们的内容指南中。
**JupyterLab 扩展**: 由社区编写的 JupyterLab 扩展可能不可访问,因为 JupyterLab 扩展可以由社区中的任何人编写,并且没有标准的审查流程。我们无法也不可能审查每个 JupyterLab 扩展。为了支持可访问的扩展,我们鼓励扩展作者在其扩展中使用现有的、可访问的 JupyterLab 组件。我们还定期提供社区可访问性教育的机会。请将问题报告给作者,并让他们知道 jupyter/accessibility 社区可能能够提供指导。
评估方法#
Jupyter 可访问性贡献者通过以下方法评估了 JupyterLab 的可访问性
自我评估
定期进行自动化测试以监控回归(可以在 jupyter-a11y-testing 存储库 中找到)。
用户反馈
评估报告#
JupyterLab 的评估可在以下位置获得:jupyterlab/jupyterlab/issues/9399。
有关 JupyterLab 可访问性的用户报告可在以下位置获得:jupyterlab/jupyterlab 标签 `tag:accessibility`。
社区正在做什么#
支持可访问性的措施#
Jupyter 可访问性贡献者采取以下措施来确保 JupyterLab 的可访问性
将可访问性纳入我们的使命宣言。
为我们的社区提供持续的可访问性培训。
分配明确的可访问性目标和责任。
采用正式的可访问性质量保证方法。
记录上述方法以及 JupyterLab 本身的更改、方法和改进。
注意
有关当前改进 JupyterLab 可访问性的努力的更多信息,请访问 CZI - JupyterLab 可访问性资助路线图。
反馈和正式投诉#
我们欢迎您对 JupyterLab 的可访问性状态提供反馈和正式投诉。如果您在 JupyterLab 上遇到可访问性障碍,请告诉我们。
如果您有兴趣参与任何潜在的研究或有组织的反馈计划,请通过众多 JupyterLab 社区渠道之一与我们联系。衡量社区对用户研究参与的兴趣有助于我们获得支持,使其成为现实。
警告
在撰写本文时,还没有非公开的方式与我们联系以解决 JupyterLab 的可访问性问题。
请注意,JupyterLab 是一个开源项目,Jupyter 无障碍贡献者是一个自愿组成的团队。与许多其他开源项目一样,我们无法保证对问题做出响应和解决问题需要多长时间,但我们会尽力在资源允许的情况下尽快解决。感谢您的耐心和理解。