aria-component
无障碍访问
为了更好地满足视障人士对于小程序的访问需求,基础库自2.7.1起,支持部分ARIA标签。
无障碍特性在读屏模式下可以访问,iOS可通过设置->通用->辅助功能->旁白打开。
以 view 组件为例,开发者可以增加aria-role
和aria-label
属性。其中aria-role
表示组件的角色,当设置为'img'时,读屏模式下聚焦后系统会朗读出'图像'。设置为'button'时,聚焦后后系统朗读出'按钮'。aria-label
表示组件附带的额外信息,聚焦后系统会自动朗读出来。
小程序已经内置了一些无障碍的特性,对于非原生组件,开发者可以添加以下无障碍标签。
aria-hidden | aria-role | aria-label | aria-checked | aria-disabled |
aria-describedby | aria-expanded | aria-haspopup | aria-selected | aria-required |
aria-orientation | aria-valuemin | aria-valuemax | aria-valuenow | aria-readonly |
aria-multiselectable | aria-controls | tabindex | aria-labelledby | ria-orientation |
aia-multiselectable | aria-labelledby |
示例代码
<view aria-role="button" aria-label="提交表单">提交</view>
Tips
- 安卓和iOS读屏模式下设置
aria-role
后朗读的内容不同系统之间会有差异 - 可设置的
aria-role
可参看 Using Aria中的Widget Roles
,部分role的设置在移动端可能无效。