a11y(iOS): nested `<Text role="link" />` not focusable on iOS
还没有人认领这个 Issue。
- 主要语言
- C++
- 星标
- 127k
- 派生
- 25.3k
- 平均合并
- 1 天 23 小时
- 30 天内合并 PR
- 4
描述
Description
<Text role="link" /> element nested in <Text /> is not focusable by screen reader on iOS.
Example code
<Text style={styles.text}>
Regular Text
<Text role="link" onPress={handlePress}>Link Text</Text>
</Text>
On iOS it focuses only the top-level Text element, there is no focus on child text element with link role.
on Android it focuses first on top-level Text element (announcing: "contains links"), then focuses on child text element with link role.
This is especially hard to solve, if I would want to have 2+ links inside the text.
Steps to reproduce
- Clone https://github.com/mdjastrzebski/ReproLinkText
- Run under screen reader on iOS (& Android for comparison)
React Native Version
0.81.0
Affected Platforms
Runtime - iOS
Output of npx @react-native-community/cli info
info Fetching system and libraries information...
System:
OS: macOS 15.6
CPU: (11) arm64 Apple M3 Pro
Memory: 183.14 MB / 36.00 GB
Shell:
version: "5.9"
path: /bin/zsh
Binaries:
Node:
version: 22.17.1
path: ~/.nvm/versions/node/v22.17.1/bin/node
Yarn:
version: 3.6.4
path: ~/.nvm/versions/node/v22.17.1/bin/yarn
npm:
version: 10.9.2
path: ~/.nvm/versions/node/v22.17.1/bin/npm
Watchman:
version: 2025.07.28.00
path: /opt/homebrew/bin/watchman
Managers:
CocoaPods:
version: 1.15.2
path: /Users/mdj/.rbenv/shims/pod
SDKs:
iOS SDK:
Platforms:
- DriverKit 24.5
- iOS 18.5
- macOS 15.5
- tvOS 18.5
- visionOS 2.5
- watchOS 11.5
Android SDK:
API Levels:
- "35"
- "36"
Build Tools:
- 35.0.0
- 36.0.0
System Images:
- android-35 | Google Play ARM 64 v8a
- android-36 | Google Play ARM 64 v8a
Android NDK: Not Found
IDEs:
Android Studio: 2025.1 AI-251.25410.109.2511.13752376
Xcode:
version: 16.4/16F6
path: /usr/bin/xcodebuild
Languages:
Java:
version: 17.0.16
path: /usr/bin/javac
Ruby:
version: 3.4.5
path: /Users/mdj/.rbenv/shims/ruby
npmPackages:
"@react-native-community/cli":
installed: 20.0.0
wanted: 20.0.0
react:
installed: 19.1.0
wanted: 19.1.0
react-native:
installed: 0.81.0
wanted: 0.81.0
react-native-macos: Not Found
npmGlobalPackages:
"*react-native*": Not Found
Android:
hermesEnabled: true
newArchEnabled: true
iOS:
hermesEnabled: true
newArchEnabled: false
Stacktrace or Logs
N/A
MANDATORY Reproducer
https://github.com/mdjastrzebski/ReproLinkText
Screenshots and Videos
iOS (incorrect):
https://github.com/user-attachments/assets/623b4a6d-2ba2-4a7d-a659-7f16386c7ca2
Android (correct):
https://github.com/user-attachments/assets/216921f8-6f59-4261-b75f-574a7cb1de0e
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
从必需的 ReproLinkText 复现器开始,并在 iOS 上使用 VoiceOver 运行它,将其嵌套 Text 行为与 Android 进行比较。跟踪涉及嵌套 role="link" 元素的 React Native Text 无障碍入口点;完成标准是子链接在 iOS 上获得焦点(包括多个链接的情况),同时现有的 Android 行为保持不变。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- ios, react-native, typescript
- 领域
- accessibility, mobile
- Issue 类型
- 缺陷
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 活跃度
- 冷清
- 描述清晰度
- 基本清楚
- 新手友好度
- 48/100