渐进式编程课
React Native 目录
第 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 未见废弃标记)。

官方参考