第 17 课2026.09.22
让屏幕阅读器明确说明按钮会重新刷新课程列表。
第 17 课:为重试按钮设置无障碍名称
- 日期:2026-09-22
- 课程序号:第 17 课
- 知识点:
Pressable.accessibilityLabel
用途或适用场景
让屏幕阅读器明确说明按钮会重新刷新课程列表。
核心概念
accessibilityLabel 是辅助技术朗读的操作名称;它不替代按钮的可见 Text,也不改变刷新逻辑。
最小代码或操作示例
tsx
// 沿用第 16 课的 refreshing、reload 和 lastSuccess。
<>
<Pressable disabled={refreshing} onPress={reload}
accessibilityLabel="重试刷新课程列表">
<Text>{refreshing ? '重试中…' : '重试'}</Text>
</Pressable>
<Text>{lastSuccess ? `上次成功:${lastSuccess.toLocaleTimeString()}` : '尚未成功刷新'}</Text>
</>3~5 分钟练习
启用 VoiceOver 或 TalkBack,聚焦重试按钮并听取名称。
参考答案
朗读名称为“重试刷新课程列表”;按钮可见文字仍为“重试”或“重试中…”。
与上一课的联系
沿用第 16 课的 reload、refreshing 与 lastSuccess 显示;本课只为已存在的重试按钮增加 accessibilityLabel;完成后下一课可在刷新失败时保留成功时间并新增内联提示。
时效校验
时效校验:2026-09-24(React Native 当前 Accessibility 与 Pressable 文档;accessibilityLabel 未见废弃标记)。