JupyterLab 无障碍声明#

注意

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

Jupyter Notebook 与 JupyterLab#

出于可访问性的考虑，建议使用Jupyter Notebook 而不是JupyterLab。

比较这两个应用程序将有助于解释这一推荐。Jupyter Notebook 和 JupyterLab 都是用于编写计算笔记本的网页应用程序。但 Jupyter Notebook 有一个以文档为中心的用户界面，而 JupyterLab 提供了多个面板和标签，设计用于在同一界面中处理多个笔记本和扩展。Jupyter Notebook 更像 Google Docs，其中每个文档在单独的浏览器标签中打开。JupyterLab 更像网页版的 VS Code，应用程序提供自己的应用内标签，因此可以打开多个文档而无需打开更多浏览器标签。由于 Jupyter Notebook 具有简化的用户界面，它比 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 Content Accessibility Guidelines (WCAG) 定义了设计师和开发者需要满足的要求，以提高残障人士的可访问性。它定义了三个符合性级别：A级、AA级和AAA级。JupyterLab不符合WCAG 2.0 AA级（相当于美国的Section 508）。不符合意味着内容未达到可访问性标准。

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

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

JupyterLab 设计为与以下内容兼容#

操作系统：

  • Windows

  • macOS

  • Linux

  • iOS

  • 安卓

浏览器（移动和桌面）：

  • 火狐浏览器

  • Chrome

  • Safari

  • Chromium 浏览器

JupyterLab 与#不兼容

操作系统：

浏览器（移动和桌面）：

  • Internet Explorer

  • Edge 小于 79

辅助技术：

技术规格#

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

  • 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 可访问性贡献者是一个基于自愿原则定义的群体。与许多其他开源项目一样，我们无法保证响应和解决问题所需的时间，但我们会尽力利用我们的资源尽快完成。

感谢您的耐心和理解。