JupyterLab 可访问性声明#

注意

本声明最后更新于 2024 年 7 月 22 日。

Jupyter Notebook 与 JupyterLab#

出于可访问性目的，建议使用 Jupyter Notebook <https://notebook.jupyter.org.cn/en/latest/> 而不是 JupyterLab。

对这两个应用程序的比较将有助于解释此建议。Jupyter Notebook 和 JupyterLab 都是用于创作计算笔记本的网络应用程序。但 Jupyter Notebook 具有以文档为中心的用户界面，而 JupyterLab 提供多个面板和选项卡，旨在在同一界面中处理多个笔记本和扩展。Jupyter Notebook 更像 Google Docs，每个文档都在单独的浏览器选项卡中打开。JupyterLab 更像 VS Code for the Web，应用程序提供自己的应用内选项卡，因此无需打开更多浏览器选项卡即可打开多个文档。由于 Jupyter Notebook 具有简化的 UI，它比 JupyterLab 带来的可访问性挑战更少（特别是更容易放大）。但由于它共享相同的代码库，它也受益于 JupyterLab 中完成的所有可访问性工作。这就是为什么推荐使用 Jupyter Notebook 而不是 JupyterLab 的原因。

Jupyter 审计#

本节包含来自不同利益相关者对 Jupyter 产品的审计。

这些审计中发现的许多问题可以在带有 tag:Accessibility 标签的问题中进行跟踪。

JupyterLab 可访问性声明#

摘自 W3C 可访问性声明生成器

这是 Jupyter 可访问性贡献者为 JupyterLab 提供的可访问性声明。

JupyterLab 的当前状态#

Jupyter 可访问性声明是动态文档。本声明于 2022 年 5 月 16 日首次为 JupyterLab 3.4.4 创建，使用了 W3C 可访问性声明生成器工具，并由 Jupyter 可访问性贡献者社区进行了添加和编辑。

符合性状态#

Web 内容可访问性指南 (WCAG) 定义了设计师和开发人员为改善残障人士可访问性而需要满足的要求。它定义了三个符合性级别：A 级、AA 级和 AAA 级。JupyterLab 不符合 WCAG 2.0 AA 级（相当于美国 Section 508）。不符合意味着内容不符合可访问性标准。

JupyterLab 的可访问性并非孤立存在。JupyterLab 继承了它所构建的许多项目，其可访问性符合性可能会影响基于 JupyterLab 或其组件构建的项目。这个生态系统的可访问性是相互关联的，因此可能需要在不同级别解决符合性问题，以便对 JupyterLab 产生积极影响。

与浏览器和辅助技术的兼容性#

JupyterLab 旨在与以下内容兼容#

操作系统

  • Windows

  • macOS

  • Linux

  • iOS

  • Android

浏览器（移动和桌面）

  • Firefox

  • Chrome

  • Safari

  • Chromium 浏览器

JupyterLab 不兼容#

操作系统

浏览器（移动和桌面）

  • Internet Explorer

  • Edge < 79

辅助技术

技术规范#

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

  • HTML

  • WAI-ARIA

  • CSS

  • JavaScript

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

限制和替代方案#

尽管我们尽最大努力确保 JupyterLab 的可访问性，但可能存在一些限制。以下是已知限制和潜在解决方案的描述。如果您发现以下未列出的问题，请联系我们。

JupyterLab 的已知限制

  1. 文档：社区编写的文档可能不包含可访问内容，因为我们无法审查 JupyterLab 中可以打开和编辑的每个文档。为了支持可访问文档，我们正在起草可访问文档内容的指南，重点关注 Jupyter 笔记本。请向作者报告问题，并在 jupyter/accessibility 上打开一个问题，描述问题和您期望的行为，以便我们将其整合到我们的内容指南中。

  2. JupyterLab 扩展：社区编写的 JupyterLab 扩展可能无法访问，因为 JupyterLab 扩展可以由社区中的任何人编写，并且没有标准的审查流程。我们无法审查每个 JupyterLab 扩展。为了支持可访问的扩展，我们鼓励扩展作者为其扩展使用现有的可访问 JupyterLab 组件。我们还定期提供社区可访问性教育的机会。请向作者报告问题，并告知他们 jupyter/accessibility 社区可能能够提供指导。

评估方法#

Jupyter 可访问性贡献者通过以下方法评估了 JupyterLab 的可访问性

评估报告#

社区正在做什么#

支持可访问性的措施#

Jupyter 可访问性贡献者采取以下措施确保 JupyterLab 的可访问性

  • 将可访问性纳入我们的使命声明。

  • 为我们的社区提供持续的可访问性培训。

  • 分配明确的可访问性目标和职责。

  • 采用正式的可访问性质量保证方法。

  • 记录上述方法和 JupyterLab 本身的变化、方法和改进。

反馈和正式投诉#

我们欢迎您对 JupyterLab 可访问性状态的反馈和正式投诉。如果您在 JupyterLab 上遇到可访问性障碍，请告知我们

请注意，没有私人方式联系我们解决 JupyterLab 可访问性问题。

另请注意，JupyterLab 是一个开源项目，Jupyter 可访问性贡献者是一个自愿性质的团体。像许多其他开源项目一样，我们无法保证解决问题需要多长时间，但我们会尽力以我们拥有的资源尽可能快地解决问题。

感谢您的耐心和理解。