Web 无障碍

WAI-ARIA,由 W3C 开发的无障碍富互联网应用程序套件,定义了一种方法,使残障人士可以更轻松地访问网络内容和网络应用程序。

ECharts 4.0 符合该规范,支持根据图表配置智能生成描述,以便在阅读设备的帮助下,视障人士可以理解图表的内容。Apache ECharts 5 支持贴花图案,除了颜色之外,还允许通过贴花图案来区分图表数据,为色盲人士提供更好的体验。

此无障碍功能默认关闭。可以通过将 aria.show 的值设置为 true 来启用它。

图表标签

aria.show 设置为 true 后,ECharts 将根据标题、图表、数据等自动生成图表描述。用户还可以通过配置对象手动设置描述。

示例配置对象

option = {
  aria: {
    show: true
  },
  title: {
    text: 'Referrer of a User',
    x: 'center'
  },
  series: [
    {
      name: 'Referrer',
      type: 'pie',
      data: [
        { value: 335, name: 'Direct Visit' },
        { value: 310, name: 'Email Marketing' },
        { value: 234, name: 'Union Ad' },
        { value: 135, name: 'Video Ad' },
        { value: 1548, name: 'Search Engine' }
      ]
    }
  ]
};

在图表 HTML 上添加 aria-label 属性,以启用 aria。屏幕阅读器使用此属性来描述内容;此图表将具有以下描述

This is a chart about "Referrer of a User" with type Pie chart named Referrer. The data is as follows: the data of Direct Visit is 335,the data of Mail Marketing is 310,the data of Union Ad is 234,the data of Video Ad is 135,the data of Search Engine is 1548.

将使用已配置的语言来构建描述。

自定义标题

aria-label 以一般描述开头。有两个模板,aria.general.withTitle 在存在 title.text 时使用,aria.general.withoutTitle 在未定义 title.text 时使用。

withTitle 模板中,字符串 {title}title.text 替换。模板 This is a chart named {title},标题为 Referrer of a User,将生成 This is a chart named Referrer of a User

自定义描述

系列和数据的描述在标题之后添加。对于某些图表,默认项目描述无法显示图表上的所有信息。在以下散点图中,默认生成的描述包括所有项目,但由于项目数量太多,列表太长而无法理解,因此无法访问。

在这种情况下,应使用 aria.description 属性设置描述。

深度自定义

aria-label 的每个部分都可以包含模板变量,由图表中的实际值替换。有关生成描述过程的更多信息,请参阅 API 文档:aria.label

贴花图案

此外,Apache ECharts 5 增加对贴花图案的支持,作为颜色的辅助表示,以进一步区分数据。将 aria.enabled 设置为 true,并将 aria.decal.show 设置为 true,将应用默认贴花样式。

如果你需要自定义贴花图案,可以使用 aria.decal.decals 配置灵活的贴花图案。

有关更多详细信息,请参阅 ARIA 选项

贡献者 在 GitHub 上编辑此页面

pissang pissangOvilia Oviliajulien-deramond julien-deramondzachary-svoboda-accesso zachary-svoboda-accesso