Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add support for accessibilityValue #12510

Closed
Tracked by #11901
YajurG opened this issue Dec 8, 2023 · 0 comments · Fixed by #14212
Closed
Tracked by #11901

Add support for accessibilityValue #12510

YajurG opened this issue Dec 8, 2023 · 0 comments · Fixed by #14212
Assignees
Labels
Area: Accessibility enhancement Workstream: Accessibility Ensure RNW Fabric apps are properly accessible.
Milestone

Comments

@YajurG
Copy link
Contributor

YajurG commented Dec 8, 2023

Documentation

accessibilityValue documentation: https://reactnative.dev/docs/accessibility#accessibilityvalue

Behavior Explanation

From the documentation:
"Represents the current value of a component. It can be a textual description of a component's value, or for range-based components, such as sliders and progress bars, it contains range information (minimum, current, and maximum).

accessibilityValue is an object. It contains the following fields:

NAME DESCRIPTION TYPE REQUIRED
min The minimum value of this component's range. integer Required if now is set.
max The maximum value of this component's range. integer Required if now is set.
now The current value of this component's range. integer No
text A textual description of this component's value. Will override min, now, and max if set. string No

"
On the native side our platform should take the accessibilityValue data and store the data in UIA through the IValueProvider or IRangeValueProvider. The data should then be able to be read aloud through a screen reader.

Implementation Plan

In our native implementation of accessibilityValue we should:

  1. Check that the control support value or range data.
  2. Pass the value/range data to the IValueProvider/IRangeValueProvider APIs

Note this prop will be somewhat control type dependent because different controls will store different kinds of data and some may not support value/range data at all.

Past Implementation

#5080
#10318
#5619

Notes

To Be Clarified

It is unclear in documentation what the behavior should be if a control should not support value/range data but an accessibilityValue is supplied. Should the value be ignored, or should the native code add a IValueProvider for the control?

@microsoft-github-policy-service microsoft-github-policy-service bot added the Needs: Triage 🔍 New issue that needs to be reviewed by the issue management team (label applied by bot) label Dec 8, 2023
@YajurG YajurG changed the title accessibilityValue Add support for accessibilityValue Dec 8, 2023
@YajurG YajurG self-assigned this Dec 8, 2023
@chrisglein chrisglein removed the Needs: Triage 🔍 New issue that needs to be reviewed by the issue management team (label applied by bot) label Dec 14, 2023
@microsoft-github-policy-service microsoft-github-policy-service bot added the Invalid Triage https://github.com/microsoft/react-native-windows/wiki/Triage-Process (label applied by bot) label Dec 15, 2023
@chrisglein chrisglein added this to the Backlog milestone Dec 19, 2023
@chrisglein chrisglein added enhancement and removed Invalid Triage https://github.com/microsoft/react-native-windows/wiki/Triage-Process (label applied by bot) labels Dec 19, 2023
@Yajur-Grover Yajur-Grover assigned Yajur-Grover and unassigned YajurG Feb 5, 2024
@Yajur-Grover Yajur-Grover removed their assignment Apr 24, 2024
@chiaramooney chiaramooney added the Workstream: Accessibility Ensure RNW Fabric apps are properly accessible. label Oct 3, 2024
@chiaramooney chiaramooney self-assigned this Oct 4, 2024
@chiaramooney chiaramooney modified the milestones: Backlog, Next Dec 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Area: Accessibility enhancement Workstream: Accessibility Ensure RNW Fabric apps are properly accessible.
Projects
None yet
4 participants