无障碍辅助功能

为什么我们需要无障碍辅助功能？

网络无障碍辅助功能（Accessibility，也被称为 **a11y**，因为以 A 开头，以 Y 结尾，中间一共 11 个字母）是一种可以帮助所有人获得服务的设计和创造。无障碍辅助功能是使得辅助技术正确解读网页的必要条件。

React 对于创建可访问网站有着全面的支持，而这通常是通过标准 HTML 技术实现的。

标准和指南

WCAG

网络内容无障碍指南（Web Content Accessibility Guidelines，WCAG） 为开发无障碍网站提供了指南。

下面的 WCAG 检查表提供了一些概览：

• Wuhcag 提供的 WCAG 检查表（WCAG checklist from Wuhcag）
• WebAIM 提供的 WCAG 检查表（WCAG checklist from WebAIM）
• A11Y Project 提供的检查表（Checklist from The A11Y Project）

WAI-ARIA

网络无障碍倡议 - 无障碍互联网应用（Web Accessibility Initiative - Accessible Rich Internet Applications） 文件包含了创建完全无障碍 JavaScript 部件所需要的技术。

注意：JSX 支持所有 aria-* HTML 属性。虽然大多数 React 的 DOM 变量和属性命名都使用驼峰命名（camelCased），但 aria-* 应该像其在 HTML 中一样使用带连字符的命名法（也叫诸如 hyphen-cased，kebab-case，lisp-case)。

<input
  type="text"
  aria-label={labelText}  aria-required="true"  onChange={onchangeHandler}
  value={inputValue}
  name="name"
/>

语义化的 HTML

语义化的 HTML 是无障碍辅助功能网络应用的基础。 利用多种 HTML 元素来强化您网站中的信息通常可以使您直接获得无障碍辅助功能。

• MDN 的 HTML 元素参照（MDN HTML elements reference）

有时，语义化的 HTML 会被破坏。比如当在 JSX 中使用 元素来实现 React 代码功能的时候，又或是在使用列表（， 和）和 HTML `` 时。 在这种情况下，我们应该使用 React Fragments 来组合各个组件。

举个例子，

import React, { Fragment } from 'react';
function ListItem({ item }) {
  return (
    <Fragment>      <dt>{item.term}</dt>
      <dd>{item.description}</dd>
    </Fragment>  );
}

function Glossary(props) {
  return (
    <dl>
      {props.items.map(item => (
        <ListItem item={item} key={item.id} />
      ))}
    </dl>
  );
}

和其他的元素一样，你可以把一系列的对象映射到一个 fragment 的数组中。

function Glossary(props) {
  return (
    <dl>
      {props.items.map(item => (
        // Fragments should also have a `key` prop when mapping collections
        <Fragment key={item.id}>          <dt>{item.term}</dt>
          <dd>{item.description}</dd>
        </Fragment>      ))}
    </dl>
  );
}

当你不需要在 fragment 标签中添加任何 prop 且你的工具支持的时候，你可以使用 短语法：

function ListItem({ item }) {
  return (
    <>      <dt>{item.term}</dt>
      <dd>{item.description}</dd>
    </>  );
}

更多信息请参见 Fragments 文档。

无障碍表单

标记

所有的 HTML 表单控制，例如 和 ，都需要被标注来实现无障碍辅助功能。我们需要提供屏幕朗读器以解释性标注。

以下资源向我们展示了如何写标注：

• W3C 向我们展示如何标注元素
• WebAIM 向我们展示如何标注元素
• Paciello Group 解释什么是无障碍名称

尽管这些标准 HTML 实践可以被直接用在 React 中，请注意 for 在 JSX 中应该被写作 htmlFor：

<label htmlFor="namedInput">Name:</label><input id="namedInput" type="text" name="name"/>

在出错时提醒用户

当出现错误时，所有用户都应该知情。下面的链接告诉我们如何给屏幕朗读器设置错误信息：

• W3C 展示用户推送
• WebAIM 关于表单校验的文章

控制焦点

确保你的网络应用在即使只拥有键盘的环境下正常运作。

• WebAIM 讨论使用键盘进行无障碍访问

键盘焦点及焦点轮廓

键盘焦点的定义是：在 DOM 中，当前被选中来接受键盘信息的元素。我们可以在各处看到键盘焦点，它会被焦点轮廓包围，像下面的这个图像一样。

![选中的链接被蓝色键盘焦点轮廓包围着。](https://www.tkcnn.com/react/img/keyboard-focus.png)

请不要使用 CSS 移除这个轮廓，比如设置 outline: 0，除非你将使用其他的方法实现焦点轮廓。

跳过内容机制

为了帮助和提速键盘导航，我们提供了一种机制，可以帮助用户跳过一些导航段落。

跳转链接（Skiplinks），或者说跳转导航链接（Skip Navigation Links）是一种隐藏的导航链接，它只会在使用键盘导航时可见。使用网页内部锚点和一些式样可以很容易地实现它：

• WebAIM - 跳转导航链接（Skip Navigation Links）

另外，使用地标元素和角色，比如 和，作为辅助来划分网页的区域可以让用户快速导航至这些部分。

你可以通过下面的链接了解更多如何使用这些元素来增强无障碍辅助功能：

• 无障碍地标

使用程序管理焦点

我们的 React 应用在运行时会持续更改 HTML DOM，有时这将会导致键盘焦点的丢失或者是被设置到了意料之外的元素上。为了修复这类问题，我们需要以编程的方式让键盘聚焦到正确的方向上。比方说，在一个弹窗被关闭的时候，重新设置键盘焦点到弹窗的打开按钮上。

MDN Web 文档关注了这个问题并向我们解释了可以如何搭建 可用键盘导航的 JavaScript 部件 。

我们可以用 DOM 元素的 Refs 在 React 中设置焦点。

用以上技术，我们先在一个 class 组件的 JSX 中创建一个元素的 ref：

class CustomTextInput extends React.Component {
  constructor(props) {
    super(props);
    // 创造一个 textInput DOM 元素的 ref    this.textInput = React.createRef();  }
  render() {
  // 使用 `ref` 回调函数以在实例的一个变量中存储文本输入 DOM 元素  //（比如，this.textInput）。    return (
      <input
        type="text"
        ref={this.textInput}      />
    );
  }
}

然后我们就可以在需要时于其他地方把焦点设置在这个组件上：

focus() {
  // 使用原始的 DOM API 显式地聚焦在 text input 上
  // 注意：我们通过访问 “current” 来获得 DOM 节点
  this.textInput.current.focus();
}

有时，父组件需要把焦点设置在其子组件的一个元素上。我们可以通过在子组件上设置一个特殊的 prop 来 对父组件暴露 DOM refs 从而把父组件的 ref 传向子节点的 DOM 节点。

function CustomTextInput(props) {
  return (
    <div>
      <input ref={props.inputRef} />    </div>
  );
}

class Parent extends React.Component {
  constructor(props) {
    super(props);
    this.inputElement = React.createRef();  }
  render() {
    return (
      <CustomTextInput inputRef={this.inputElement} />    );
  }
}

// 现在你就可以在需要时设置焦点了
this.inputElement.current.focus();

当使用 HOC 来扩展组件时，我们建议使用 React 的 forwardRef 函数来向被包裹的组件 转发 ref 。如果第三方的 HOC 不支持转发 ref，上面的方法仍可以作为一种备选方案。

react-aria-modal 提供了一个很好的焦点管理的例子。 这是一个少有的完全无障碍的模态窗口的例子。它不仅仅把初始焦点设置在了取消按钮上（防止键盘用户意外激活成功操作）和把键盘焦点固定在了窗口之内， 关闭窗口时它也会把键盘焦点重置到打开窗口的那一个元素上。

注意:

虽然这是一个非常重要的无障碍辅助功能，但它也是一种应该谨慎使用的技术。 我们应该在受到干扰时使用它来修复键盘焦点，而不是试图预测用户想要如何使用应用程序。

鼠标和指针事件

确保任何可以使用鼠标和指针完成的功能也可以只通过键盘完成。只依靠指针会产生很多使键盘用户无法使用你的应用的情况。

为了说明这一点，让我们看一下由点击事件引起的破坏无障碍访问的典型示例：外部点击模式，用户可以通过点击元素以外的地方来关闭已打开的弹出框。

通常实现这个功能的方法是在 window 对象中附上一个 click 事件以关闭弹窗：

class OuterClickExample extends React.Component {
  constructor(props) {
    super(props);

    this.state = { isOpen: false };
    this.toggleContainer = React.createRef();

    this.onClickHandler = this.onClickHandler.bind(this);
    this.onClickOutsideHandler = this.onClickOutsideHandler.bind(this);
  }

  componentDidMount() {    window.addEventListener('click', this.onClickOutsideHandler);  }
  componentWillUnmount() {
    window.removeEventListener('click', this.onClickOutsideHandler);
  }

  onClickHandler() {
    this.setState(currentState => ({
      isOpen: !currentState.isOpen
    }));
  }

  onClickOutsideHandler(event) {    if (this.state.isOpen && !this.toggleContainer.current.contains(event.target)) {      this.setState({ isOpen: false });    }  }
  render() {
    return (
      <div ref={this.toggleContainer}>
        <button onClick={this.onClickHandler}>Select an option</button>
        {this.state.isOpen && (
          <ul>
            <li>Option 1</li>
            <li>Option 2</li>
            <li>Option 3</li>
          </ul>
        )}
      </div>
    );
  }
}

当用户使用指针设备，比如鼠标时，这样做没有问题。但是当只使用键盘时，因为 window 对象不会接受到 click 事件，用户将无法使用 tab 切换到下一个元素。这样会导致用户无法使用你应用中的一些内容，导致不完整的用户体验。

使用正确的事件触发器，比如 onBlur 和 onFocus，同样可以达成这项功能：

class BlurExample extends React.Component {
  constructor(props) {
    super(props);

    this.state = { isOpen: false };
    this.timeOutId = null;

    this.onClickHandler = this.onClickHandler.bind(this);
    this.onBlurHandler = this.onBlurHandler.bind(this);
    this.onFocusHandler = this.onFocusHandler.bind(this);
  }

  onClickHandler() {
    this.setState(currentState => ({
      isOpen: !currentState.isOpen
    }));
  }

  // 我们在下一个时间点使用 setTimeout 关闭弹窗。  // 这是必要的，因为失去焦点事件会在新的焦点事件前被触发，  // 我们需要通过这个步骤确认这个元素的一个子节点  // 是否得到了焦点。  onBlurHandler() {    this.timeOutId = setTimeout(() => {      this.setState({        isOpen: false      });    });  }
  // 如果一个子节点获得了焦点，不要关闭弹窗。  onFocusHandler() {    clearTimeout(this.timeOutId);  }
  render() {
    // React 通过把失去焦点和获得焦点事件传输给父节点    // 来帮助我们。    return (
      <div onBlur={this.onBlurHandler}           onFocus={this.onFocusHandler}>        <button onClick={this.onClickHandler}
                aria-haspopup="true"
                aria-expanded={this.state.isOpen}>
          Select an option
        </button>
        {this.state.isOpen && (
          <ul>
            <li>Option 1</li>
            <li>Option 2</li>
            <li>Option 3</li>
          </ul>
        )}
      </div>
    );
  }
}

以上代码使得键盘和鼠标用户都可以使用我们的功能。请注意我们添加了 aria-* props 以服务屏幕朗读器用户。作为一个简单的例子，我们没有实现使用方向键来与弹窗互动。

这只是众多只依赖于鼠标和指针的程序破坏键盘用户的例子之一。始终使用键盘测试会让你迅速发现这些问题，你可以使用适用于键盘的事件处理器来修复这些问题。

更复杂的部件

一个更加复杂的用户体验并不意味着更加难以访问。通过尽可能接近 HTML 编程，无障碍访问会变得更加容易，即使最复杂的部件也可以实现无障碍访问。

这里我们需要了解 ARIA Roles 和 ARIA States and Properties 的知识。 其中有包含了多种 HTML 属性的工具箱，这些 HTML 属性被 JSX 完全支持并且可以帮助我们搭建完全无障碍，功能强大的 React 组件。

每一种部件都有一种特定的设计模式，并且用户和用户代理都会期待使用相似的方法使用它：

• WAI-ARIA 创作实践 —— 设计模式和部件
• Heydon Pickering - ARIA Examples
• 包容性组件（Inclusive Components）

其他考虑因素

设置语言

为了使屏幕朗读器可以使用正确的语音设置，请在网页上设置正确的人类语言：

• WebAIM —— 文档语言

设置文档标题

为了确保用户可以了解当前网页的内容，我们需要把文档的 `` 设置为可以正确描述当前页面的文字。

• WCAG —— 理解文档标题的要求

在 React 中，我们可以使用 React 文档标题组件（React Document Title Component）来设置标题。

色彩对比度

为了尽可能让视力障碍用户可以阅读你网站上的所有可读文字，请确保你的文字都有足够的色彩对比度。

• WCAG —— 理解色彩对比度要求
• 有关色彩对比度的一切以及为何你应该重新考虑它
• A11yProject —— 什么是色彩对比度

手工计算你网站上所有恰当的色彩组合会是乏味的。所以，作为代替，你可以 使用 Colorable 来计算出一个完全无障碍的调色板 。

下面介绍的 aXe 和 WAVE 都支持色彩对比度测试并会报告对比度错误。

如果你想扩展对比度测试能力，可以使用以下工具：

• WebAIM —— 色彩对比度检验工具
• The Paciello Group —— 色彩对比度分析工具

开发及测试

我们可以利用很多工具来帮助我们创建无障碍的网络应用。

键盘

最最简单也是最最重要的检测是确保你的整个网站都可以被只使用键盘的用户使用和访问。你可以通过如下步骤进行检测：

1. 断开鼠标
2. 使用 Tab 和 Shift+Tab 来浏览。
3. 使用 Enter 来激活元素。
4. 当需要时，使用键盘上的方向键来和某些元素互动，比如菜单和下拉选项。

开发辅助

我们可以直接在 JSX 代码中检测一些无障碍复制功能。通常支持 JSX 的 IDE 会针对 ARIA roles，states 和 properties 提供智能检测。我们也可以使用以下工具：

eslint-plugin-jsx-a11y

ESLint 中的 eslint-plugin-jsx-a11y 插件为你的 JSX 中的无障碍问题提供了 AST 的语法检测反馈。许多 IDE 都允许你把这些发现直接集成到代码分析和源文件窗口中。

Create React App 中使用了这个插件中的一部分规则。如果你想启用更多的无障碍规则，你可以在项目的根目录中创建一个有如下内容的 .eslintrc 文件：

{
  "extends": ["react-app", "plugin:jsx-a11y/recommended"],
  "plugins": ["jsx-a11y"]
}

在浏览器中测试无障碍辅助功能

已有很多工具可以在您的浏览器内进行网页的无障碍性验证。 因为它们只能检测你 HTML 的技术无障碍性，所以请将它们与这里提到的无障碍检测工具一起使用。

aXe,aXe-core 以及 react-axe

Deque 系统提供了 aXe-core 以对你的应用进行自动及端至端无障碍性测试。这个组件包含了对 Selenium 的集成。

无障碍访问引擎（The Accessibility Engine） ，简称 aXe，是一个基于 aXe-core 的无障碍访问性检测器。

在开发和 debug 时，你也可以使用 react-axe 组件直接把无障碍访问的发现显示在控制台中。

WebAIM WAVE

网络无障碍性评估工具（Web Accessibility Evaluation Tool） 也是一个无障碍辅助的浏览器插件。

无障碍辅助功能检测器和无障碍辅助功能树

无障碍辅助功能树 是 DOM 树的一个子集， 其中包含了所有 DOM 元素中应该被暴露给无障碍辅助技术（比如屏幕朗读器）的无障碍辅助对象。

在一些浏览器中，我们可以在无障碍辅助功能树中轻松的看到每个元素的无障碍辅助功能信息：

• 在 Firefox 中使用无障碍辅助功能检测器
• 在 Chrome 中激活无障碍辅助功能检测器
• 在 OS X Safari 中使用无障碍辅助功能检测器

屏幕朗读器

使用屏幕朗读器测试应该是你无障碍辅助功能测试的一部分。

请注意，浏览器与屏幕朗读器的组合很重要。我们建议在最适用于你的屏幕朗读器的浏览器中测试你的应用。

常用屏幕朗读器

火狐中的 NVDA

NonVisual Desktop Access ，简称 NVDA，是一个被广泛使用的 Windows 开源屏幕朗读器。

想要了解怎么样最好的使用 NVDA，请参考下面的指南：

• WebAIM —— 使用 NVD A来评估网络的可无障碍访问性
• Deque —— NVDA 键盘快捷键

Safari 中的 VoiceOver

VoiceOver 是苹果设备的自带屏幕朗读器。

想要了解如何激活以及使用 VoiceOver，请参考下面的指南：

• WebAIM —— 使用 VoiceOver 来评估网络的可无障碍访问性
• Deque —— OS X 中的 VoiceOver 键盘快捷键
• Deque —— iOS 中的 VoiceOver 快捷键

Internet Explorer 中的 JAWS

Job Access With Speech 又称 JAWS，是一个常用的 Windows 屏幕朗读器。

想要了解如何最好的使用 VoiceOver，请参考下面的指南：

• WebAIM —— 使用 JAWS 来评估网络的可无障碍访问性
• Deque —— JAWS 键盘快捷键

其他屏幕朗读器

Google Chrome 中的 ChromeVox

ChromeVox 是 Chromebook 的内置屏幕朗读器，同时也是 Google Chrome 中的 一个插件 。

想要了解如何最好的使用 ChromeVox，请参考下面的指南：

• Google Chromebook 帮助 —— 使用内置屏幕朗读器
• ChromeVox 经典键盘快捷键参考