第 19 课：标识内联刷新失败提示

• 日期：2026-09-24
• 课程序号：第 19 课
• 知识点：accessibilityRole="alert"

用途或适用场景

让辅助技术辨认刷新失败后新增的内联文字是警告信息。

核心概念

保留上一课的 errorMessage 作为最近一次操作的界面反馈；只为出现时的 Text 声明 alert 角色，不修改 lastSuccess。

最小代码或操作示例

// 沿用第 18 课的 reload、lastSuccess、errorMessage。
<>
  <Text>{lastSuccess ? `上次成功：${lastSuccess.toLocaleTimeString()}` : '尚未成功刷新'}</Text>
  {errorMessage ?
    <Text accessibilityRole="alert">{errorMessage}</Text> : null}
</>

3～5 分钟练习

先成功刷新一次，再触发失败；检查时间和警告文字。

参考答案

旧成功时间保留；“刷新失败，请重试”作为 alert 角色的文字显示。实际朗读时机需在目标设备上检验。

与上一课的联系

沿用第 18 课的 errorMessage、lastSuccess 与条件渲染；本课只为已有内联错误文字增加 accessibilityRole；完成后下一课可在设备上验证 VoiceOver 与 TalkBack 的朗读行为。

时效校验

时效校验：2026-09-24（React Native 当前 Accessibility 与 Text 文档；alert 角色未见废弃标记；实际设备朗读效果未在本次验证）。

官方参考

• React Native：Accessibility
• React Native：Text