Aria 实时区域

在插件面板中观察和记录 aria-live 区域的变化

在 Github 上查看

Aria 实时 Storybook 插件

调试ARIA 实时区域 非常麻烦。验证实时区域是否已连接应该很容易、自动且可以在故事中直接使用。

入门

首先,安装插件。

$ yarn add aria-live-storybook-addon

将此行添加到您的 main.js 文件中(如果需要,在您的 Storybook 配置目录中创建此文件)。

module.exports = {
  addons: ['aria-live-storybook-addon'],
};

安装后,您将获得一个新的面板:Aria 实时区域

此面板将观察您故事中 aria-live=politearia-live=assertive 元素的变化。

示例

可以在Storybook 上的 Chromatic 中找到实现示例。

限制

此插件仅确认故事中第一个 aria-live 元素的 politeassertive 类型。

在实践中,应用程序每种类型应该只有一个 aria-live 播报器。

常见问题

为什么后续事件没有显示?

当使用 React 等 UI 库时,Chrome 和 Firefox 等浏览器可能不会观察文本更改,只会观察添加。这对于此插件以及屏幕阅读器的体验都是正确的。

为了确保辅助技术的用户能够观察到更改,请确保清除 aria-live 元素的内容。

如果您正在寻找实现策略,可以考虑此使用 React Hooks 的实现

其他资源