react / react/react-native

hitSlop does not surface to Android TalkBack

未关闭
#54,187 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

Issue: Author Provided Repro Platform: Android
主要语言
C++
星标
127k
派生
25.3k
平均合并
1 天 23 小时
30 天内合并 PR
4

描述

Description

Hey folks, looks like this long standing issue is still a problem: https://github.com/facebook/react-native/issues/32089. It was closed years ago, but the issue remains. I've made a new reproducer with React Native 0.82 and recorded demos.

hitSlop does not surface its information to TalkBack on Android. It works as I would expect it to with VoiceOver on iOS.

Steps to reproduce
  1. Install the reproducer application on Android
  2. With TalkBack off, open the app and use the two buttons. There is a blue button with no hitSlop, it will show an alert.
  3. There is a red button with 100 units of hitSlop. Tap the button itself, and its hitslop area. In both cases, you'll see an alert.
  4. Now enable TalkBack. Personally, I like keeping the shortcut enabled (there are directions in this link) to toggle back and forth.
  5. Attempt to select the top button. You'll see you can only focus it if you tap directly in it.
  6. Attempt to select the bottom button. Again, you can only focus it if you tap directly in it. The hitSlop is no longer working.

To me, this means users with assistive technologies can't benefit from the wider touch targets. That means if I'm trying to expand my touch target specifically to improve accessibility (say I have a small visual element but want to give it a more reasonable touch target), the accessibility is degraded when the user enables TalkBack.

I would expect the hitSlop amount to apply to the TalkBack selection as well. And in fact, it behaves that way on iOS. You can repeat those steps on iOS and use VoiceOver to see the hitSlop works in this scenario.

React Native Version

0.82.0

Affected Platforms

Runtime - Android

Output of npx @react-native-community/cli info
HitSlop git:(main) ✗ npx @react-native-community/cli info
info Fetching system and libraries information...
System:
  OS: macOS 15.7.1
  CPU: (10) arm64 Apple M1 Pro
  Memory: 120.55 MB / 16.00 GB
  Shell:
    version: "5.9"
    path: /bin/zsh
Binaries:
  Node:
    version: 22.12.0
    path: /Users/tyler.williams/.asdf/installs/nodejs/22.12.0/bin/node
  Yarn:
    version: 4.6.0
    path: /Users/tyler.williams/.asdf/installs/nodejs/22.12.0/bin/yarn
  npm:
    version: 10.9.0
    path: /Users/tyler.williams/.asdf/plugins/nodejs/shims/npm
  Watchman:
    version: 2025.04.14.00
    path: /opt/homebrew/bin/watchman
Managers:
  CocoaPods:
    version: 1.16.2
    path: /Users/tyler.williams/.asdf/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: Not Found
IDEs:
  Android Studio: 2025.1 AI-251.26094.121.2513.14007798
  Xcode:
    version: 16.4/16F6
    path: /usr/bin/xcodebuild
Languages:
  Java:
    version: 17.0.13
    path: /Users/tyler.williams/.asdf/shims/javac
  Ruby:
    version: 3.3.0
    path: /Users/tyler.williams/.asdf/shims/ruby
npmPackages:
  "@react-native-community/cli":
    installed: 20.0.0
    wanted: 20.0.0
  react:
    installed: 19.1.1
    wanted: 19.1.1
  react-native:
    installed: 0.82.0
    wanted: 0.82.0
  react-native-macos: Not Found
npmGlobalPackages:
  "*react-native*": Not Found
Android:
  hermesEnabled: true
  newArchEnabled: true
iOS:
  hermesEnabled: true
  newArchEnabled: true
Stacktrace or Logs
N/A - this is a behavior problem, no error message.
MANDATORY Reproducer

https://github.com/coolsoftwaretyler/HitSlop-Accessibility-Bug-Reproducer

Screenshots and Videos

Here are two reproduction videos. I ran these on physical devices so I didn't get the taps recorded, but you should be able to reproduce the issue with the reproducer app and see what's going on.

Android

The TalkBack audio didn't come through Zoom but you'll still be able to see the problem by observing the focus.

https://github.com/user-attachments/assets/2ba7a653-1a9b-4330-a6f8-ec9b2238e796

iOS

https://github.com/user-attachments/assets/c9696e50-0698-4880-b656-361fa8f698ac

贡献指南

打开贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

调研方向

首先,在启用 TalkBack 的 Android 上运行链接的 HitSlop-Accessibility-Bug-Reproducer,按照列出的步骤操作,并比较 iOS VoiceOver 的行为。从 reproducer 入手,跟踪 Android 对 hitSlop 和 accessibility focus 的处理;当 TalkBack 能够像 VoiceOver 一样选择扩展后的 hitSlop 区域时,即表示完成。

由索引模型根据 Issue 内容生成。

评估

技术栈
android, react-native
领域
accessibility, mobile-dev
Issue 类型
缺陷
难度
4/5
预计耗时
3-5 天
活跃度
停滞
描述清晰度
基本清楚
新手友好度
45/100

把新 issue 发到你的邮箱

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