aria-component

无障碍访问

为了更好地满足视障人士对于小程序的访问需求,基础库自2.7.1起,支持部分ARIA标签。

无障碍特性在读屏模式下可以访问,iOS可通过设置->通用->辅助功能->旁白打开。

view 组件为例,开发者可以增加aria-rolearia-label属性。其中aria-role表示组件的角色,当设置为'img'时,读屏模式下聚焦后系统会朗读出'图像'。设置为'button'时,聚焦后后系统朗读出'按钮'。aria-label表示组件附带的额外信息,聚焦后系统会自动朗读出来。

小程序已经内置了一些无障碍的特性,对于非原生组件,开发者可以添加以下无障碍标签。

aria-hiddenaria-rolearia-labelaria-checkedaria-disabled
aria-describedbyaria-expandedaria-haspopuparia-selectedaria-required
aria-orientationaria-valueminaria-valuemaxaria-valuenowaria-readonly
aria-multiselectablearia-controlstabindexaria-labelledbyria-orientation
aia-multiselectablearia-labelledby

示例代码

  1. <view aria-role="button" aria-label="提交表单">提交</view>

Tips

  • 安卓和iOS读屏模式下设置aria-role后朗读的内容不同系统之间会有差异
  • 可设置的aria-role可参看 Using Aria中的Widget Roles,部分role的设置在移动端可能无效。