react / react/react-native

a11y(iOS): nested `<Text role="link" />` not focusable on iOS

未关闭
#53,243 3 条评论 1 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

Needs: Triage :mag: Platform: iOS
主要语言
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
  1. Clone https://github.com/mdjastrzebski/ReproLinkText
  2. 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

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 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

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。