在构建 Web 应用时,可访问性(Accessibility,简称 a11y)常常被视为“锦上添花”而非“必需品”。这种观念导致了许多用户在访问网站时遇到障碍——键盘无法导航、屏幕阅读器读不出内容、焦点管理混乱……这些问题不仅影响用户体验,甚至可能触及法律风险。
React Aria 正是为解决这一痛点而诞生的。它是由 Adobe 开源的一套无样式的 React Hooks 库,旨在帮助开发者构建高度可访问的 UI 组件。与 Material-UI、Ant Design 等提供完整组件的库不同,React Aria 不提供任何样式,只提供行为逻辑和可访问性支持。它让你完全控制组件的视觉呈现,同时确保键盘导航、屏幕阅读器支持、焦点管理等复杂的可访问性细节全部正确。
React Aria 通过提供一套强大的 Hooks,你可以快速构建出符合 WAI-ARIA 规范的高质量组件。本文将系统全面地介绍 React Aria 的核心知识点,从设计理念到安装配置,从核心 Hooks 到高级特性,帮助读者构建自己的可访问组件库。
一、React Aria 概述
1.1 什么是 React Aria
React Aria 是一套无样式的 React Hooks 库,用于构建可访问的 UI 组件。React Aria 提供了跨平台、跨设备的可访问性行为,并遵循 WAI-ARIA 规范。
与传统的 React 组件库不同,React Aria不提供任何组件,只提供 Hooks。它通过 Hooks 将行为逻辑和状态返回给开发者,让开发者自由决定组件的样式和结构。这种设计让 React Aria 可以用于构建任何类型的组件——无论是设计系统,还是直接构建应用。
React Aria 的核心价值可以概括为以下几点:
1.2 React Aria 的设计哲学
行为与样式分离(Headless UI):组件的行为和样式解耦是 React Aria 的核心设计思想。它不关心你的组件长什么样,只负责处理复杂的可访问性逻辑。你可以使用 Tailwind CSS、CSS-in-JS 或任何你喜欢的样式方案。
复合组件模式:React Aria 的 Hooks 设计为可组合的。例如,useButton Hook 可以组合 usePress 来处理点击和键盘事件,useFocusRing 来处理焦点样式。
渐进增强:React Aria 确保基本功能(如按钮点击)在任何环境下都能工作,高级功能(如触摸手势)在支持的设备上增强体验。
完整的 ARIA 支持:每个 Hook 都自动添加正确的 ARIA 属性,无需手动设置 role、aria-label、aria-expanded 等。
1.3 React Aria vs 其他解决方案
选择 React Aria 的场景:
需要构建完整的设计系统
对可访问性有严格要求
需要处理复杂交互(拖拽、虚拟滚动、大表格)
需要精细控制渲染性能
二、安装与快速入门
2.1 安装
# 使用 npm
npm install react-aria
# 使用 yarn
yarn add react-aria
# 使用 pnpm
pnpm add react-aria
2.2 基础示例 - 创建一个可访问的按钮
React Aria 的最基本 Hook 是 useButton,它为按钮元素提供完整的可访问性支持。
import { useButton } from 'react-aria';
import { useRef } from 'react';
function MyButton(props) {
let ref = useRef(null);
let { buttonProps } = useButton(props, ref);
return (
<button {...buttonProps} ref={ref} style={
{ padding: '10px 20px', background: '#007bff', color: 'white', border: 'none', borderRadius: '4px' }}>
{props.children}
</button>
);
}
function App() {
return (
<MyButton onPress={() => alert('按钮被点击了!')}>
点击我
</MyButton>
);
}
2.3 使用 TypeScript
React Aria 提供完整的 TypeScript 类型定义,确保类型安全。上述 MyButton 组件的完整类型版本如下:
import { useButton } from 'react-aria';
import { useRef } from 'react';
import type { AriaButtonProps } from 'react-aria';
interface ButtonProps extends AriaButtonProps {
children: React.ReactNode;
}
function MyButton({ children, ...props }: ButtonProps) {
let ref = useRef<HTMLButtonElement>(null);
let { buttonProps } = useButton(props, ref);
return (
<button {...buttonProps} ref={ref}>
{children}
</button>
);
}
2.4 在现有项目中使用
在已有项目中,你可以逐步采用 React Aria。例如,你可以先替换 button 元素为 useButton Hook,逐步为其他组件添加可访问性支持。
// 原有代码
<button onClick={handleClick}>提交</button>
// 替换为
import { useButton } from 'react-aria';
function SubmitButton({ onPress, children }) {
let ref = useRef();
let { buttonProps } = useButton({ onPress, elementType: 'button' }, ref);
return <button {...buttonProps} ref={ref}>{children}</button>;
}
// 使用
<SubmitButton onPress={handleClick}>提交</SubmitButton>
关键点:React Aria 支持渐进式采用,无需一次性重构所有组件。
来源:
http://fndvx.cn