From 2ca597120ae2c3ced7538263afa48e9c9b97135a Mon Sep 17 00:00:00 2001 From: Jason Morse Date: Fri, 20 Nov 2026 16:24:00 -0800 Subject: [PATCH] fix(0.83, macos): backport Fabric accessibility and TextInput fixes Backport the first-parent diff of 0b569f1497 (#3136), including the final review fixes, and add a patch changeset. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: fe49cb92-f2e6-4bc2-89f0-d7d7a795c675 --- .../fix-macos-accessibility-text-input.md | 5 + .../Text/TextInput/Multiline/RCTUITextView.mm | 34 +++ .../TextInput/Multiline/RCTWrappedTextView.m | 16 ++ .../RCTBackedTextInputViewProtocol.h | 2 + .../TextInput/Singleline/RCTUITextField.mm | 30 ++- .../react-native/React/Base/RCTConvert.mm | 3 +- .../TextInput/RCTTextInputComponentView.mm | 21 ++ .../TextInput/RCTTextInputUtils.mm | 6 +- .../View/RCTViewComponentView.mm | 240 +++++++++++++++++- .../react-native/React/Views/RCTViewManager.m | 4 + packages/rn-tester/RNTester/AppDelegate.mm | 2 + .../Accessibility/AccessibilityExample.js | 108 ++++++++ .../TextInput/TextInputExample.ios.js | 57 +++++ 13 files changed, 516 insertions(+), 12 deletions(-) create mode 100644 .changeset/fix-macos-accessibility-text-input.md diff --git a/.changeset/fix-macos-accessibility-text-input.md b/.changeset/fix-macos-accessibility-text-input.md new file mode 100644 index 000000000000..bcd931995c40 --- /dev/null +++ b/.changeset/fix-macos-accessibility-text-input.md @@ -0,0 +1,5 @@ +--- +'react-native-macos': patch +--- + +Fix macOS Fabric accessibility roles and states, keep read-only TextInputs focusable and selectable, honor disabled accessibility state, and give each Fabric TextInput a single Tab stop. diff --git a/packages/react-native/Libraries/Text/TextInput/Multiline/RCTUITextView.mm b/packages/react-native/Libraries/Text/TextInput/Multiline/RCTUITextView.mm index 8e7169c30d33..637f882ba430 100644 --- a/packages/react-native/Libraries/Text/TextInput/Multiline/RCTUITextView.mm +++ b/packages/react-native/Libraries/Text/TextInput/Multiline/RCTUITextView.mm @@ -27,6 +27,7 @@ @implementation RCTUITextView { NSArray *_acceptDragAndDropTypes; #if TARGET_OS_OSX // [macOS BOOL _enableFocusRing; + BOOL _enabled; NSArray *_readablePasteboardTypes; #endif // macOS] } @@ -66,6 +67,7 @@ - (instancetype)initWithFrame:(CGRect)frame self.canDrawSubviewsIntoLayer = YES; self.allowsUndo = YES; _enableFocusRing = YES; + _enabled = YES; #endif // macOS] _textInputDelegateAdapter = [[RCTBackedTextViewDelegateAdapter alloc] initWithTextView:self]; @@ -280,6 +282,38 @@ - (BOOL)enableFocusRing { return _enableFocusRing; } + +- (BOOL)isEnabled +{ + return _enabled; +} + +- (void)setEnabled:(BOOL)enabled +{ + if (_enabled != enabled) { + _enabled = enabled; + + // NSTextView has no enabled state. Behave like a disabled NSTextField: report AXEnabled = NO, refuse first + // responder (see -acceptsFirstResponder) and end editing if the view is focused. + self.accessibilityEnabled = enabled; + if (!enabled && self.window.firstResponder == self) { + [self.window makeFirstResponder:nil]; + } + } +} + +- (BOOL)acceptsFirstResponder +{ + return _enabled && [super acceptsFirstResponder]; +} + +- (void)setAccessibilityState:(NSDictionary *)accessibilityState +{ + // Paper routes `accessibilityState` to the backed text view through -[RCTBaseTextInputView reactAccessibilityElement]. + [super setAccessibilityState:accessibilityState]; + id disabled = accessibilityState[@"disabled"]; + self.enabled = !([disabled isKindOfClass:[NSNumber class]] && [disabled boolValue]); +} #endif // macOS] - (void)setDefaultTextAttributes:(NSDictionary *)defaultTextAttributes diff --git a/packages/react-native/Libraries/Text/TextInput/Multiline/RCTWrappedTextView.m b/packages/react-native/Libraries/Text/TextInput/Multiline/RCTWrappedTextView.m index d716f199955e..7ed3c9925630 100644 --- a/packages/react-native/Libraries/Text/TextInput/Multiline/RCTWrappedTextView.m +++ b/packages/react-native/Libraries/Text/TextInput/Multiline/RCTWrappedTextView.m @@ -108,6 +108,12 @@ - (NSResponder *)responder return _forwardingTextView; } +- (BOOL)canBecomeKeyView +{ + // The forwarding text view is the Tab stop; this wrapper would otherwise add a second one. + return NO; +} + - (BOOL)acceptsFirstResponder { return _forwardingTextView.acceptsFirstResponder; @@ -123,6 +129,16 @@ - (BOOL)resignFirstResponder return [_forwardingTextView resignFirstResponder]; } +- (BOOL)isEnabled +{ + return _forwardingTextView.isEnabled; +} + +- (void)setEnabled:(BOOL)enabled +{ + _forwardingTextView.enabled = enabled; +} + #pragma mark - #pragma mark Text Input delegate forwarding diff --git a/packages/react-native/Libraries/Text/TextInput/RCTBackedTextInputViewProtocol.h b/packages/react-native/Libraries/Text/TextInput/RCTBackedTextInputViewProtocol.h index 63a8a57e47c7..e202fd65a050 100644 --- a/packages/react-native/Libraries/Text/TextInput/RCTBackedTextInputViewProtocol.h +++ b/packages/react-native/Libraries/Text/TextInput/RCTBackedTextInputViewProtocol.h @@ -40,6 +40,8 @@ NS_ASSUME_NONNULL_BEGIN @property (nonatomic, assign) BOOL textWasPasted; @property (nonatomic, readonly) NSResponder *responder; @property (nonatomic, assign) BOOL enableFocusRing; +// Driven by `accessibilityState.disabled`; `editable` only controls whether the text can be changed. +@property (nonatomic, assign, getter=isEnabled) BOOL enabled; #endif // macOS] @property (nonatomic, assign, readonly) BOOL dictationRecognizing; @property (nonatomic, assign) UIEdgeInsets textContainerInset; diff --git a/packages/react-native/Libraries/Text/TextInput/Singleline/RCTUITextField.mm b/packages/react-native/Libraries/Text/TextInput/Singleline/RCTUITextField.mm index 0f988c19d5c2..a6048d3eb1d2 100644 --- a/packages/react-native/Libraries/Text/TextInput/Singleline/RCTUITextField.mm +++ b/packages/react-native/Libraries/Text/TextInput/Singleline/RCTUITextField.mm @@ -391,18 +391,42 @@ - (void)_updatePlaceholder - (BOOL)isEditable { +#if !TARGET_OS_OSX // [macOS] return self.isEnabled; +#else // [macOS + return [super isEditable]; +#endif // macOS] } - (void)setEditable:(BOOL)editable { -#if TARGET_OS_OSX // [macOS - // on macos the super must be called otherwise its NSTextFieldCell editable property doesn't get set. +#if !TARGET_OS_OSX // [macOS] + self.enabled = editable; +#else // [macOS + // On macOS read-only text remains selectable and focusable, matching desktop behavior rather than iOS's disabled + // field. `accessibilityState.disabled` disables it; the super call sets NSTextFieldCell's editable state. [super setEditable:editable]; + self.selectable = YES; #endif // macOS] - self.enabled = editable; } +#if TARGET_OS_OSX // [macOS +- (BOOL)acceptsFirstResponder +{ + // NSTextField refuses first responder when it is not editable, which would make read-only fields unreachable with + // Tab. Accept it while the field is enabled and selectable; disabled fields are skipped. + return self.isEnabled && self.isSelectable; +} + +- (void)setAccessibilityState:(NSDictionary *)accessibilityState +{ + // Paper routes `accessibilityState` to the backed text field through -[RCTBaseTextInputView reactAccessibilityElement]. + [super setAccessibilityState:accessibilityState]; + id disabled = accessibilityState[@"disabled"]; + self.enabled = !([disabled isKindOfClass:[NSNumber class]] && [disabled boolValue]); +} +#endif // macOS] + #if !TARGET_OS_OSX // [macOS] - (void)setSecureTextEntry:(BOOL)secureTextEntry { diff --git a/packages/react-native/React/Base/RCTConvert.mm b/packages/react-native/React/Base/RCTConvert.mm index 51287bfe5477..7e3a160d7ccd 100644 --- a/packages/react-native/React/Base/RCTConvert.mm +++ b/packages/react-native/React/Base/RCTConvert.mm @@ -1664,6 +1664,7 @@ + (NSString*)accessibilityRoleFromTrait:(NSString*)trait @"tab": NSAccessibilityButtonRole, // no exact match on macOS @"tablist": NSAccessibilityTabGroupRole, @"text": NSAccessibilityStaticTextRole, // also a legacy iOS accessibilityTraits + @"textbox": NSAccessibilityTextFieldRole, @"timer": NSAccessibilityStaticTextRole, // no exact match on macOS @"toolbar": NSAccessibilityToolbarRole, // Roles/traits that are macOS specific and are used by some of the core components (Lists): @@ -1689,7 +1690,7 @@ + (NSString *)accessibilityRoleFromTraits:(id)json useAriaMappings:(BOOL)useAria return useAriaMappings ? [RCTConvert accessibilityRoleFromAriaRole:json] : [RCTConvert accessibilityRoleFromTrait:json]; } else if ([json isKindOfClass:[NSArray class]]) { for (NSString *trait in json) { - NSString *accessibilityRole = useAriaMappings ? [RCTConvert accessibilityRoleFromAriaRole:json] : [RCTConvert accessibilityRoleFromTrait:trait]; + NSString *accessibilityRole = useAriaMappings ? [RCTConvert accessibilityRoleFromAriaRole:trait] : [RCTConvert accessibilityRoleFromTrait:trait]; if (![accessibilityRole isEqualToString:NSAccessibilityUnknownRole]) { return accessibilityRole; } diff --git a/packages/react-native/React/Fabric/Mounting/ComponentViews/TextInput/RCTTextInputComponentView.mm b/packages/react-native/React/Fabric/Mounting/ComponentViews/TextInput/RCTTextInputComponentView.mm index d22921730f60..8b31ab925153 100644 --- a/packages/react-native/React/Fabric/Mounting/ComponentViews/TextInput/RCTTextInputComponentView.mm +++ b/packages/react-native/React/Fabric/Mounting/ComponentViews/TextInput/RCTTextInputComponentView.mm @@ -255,6 +255,20 @@ - (void)reactUpdateResponderOffsetForScrollView:(RCTScrollViewComponentView *)sc #pragma mark - RCTViewComponentView overrides +#if TARGET_OS_OSX // [macOS +// The backed text input owns focus and accessibility; keep this host out of the key view loop to avoid a second Tab +// stop. `focus()` targets the backed view. +- (BOOL)canBecomeKeyView +{ + return NO; +} + +- (BOOL)acceptsFirstResponder +{ + return NO; +} +#endif // macOS] + - (NSObject *)accessibilityElement { return _backedTextInputView; @@ -305,6 +319,13 @@ - (void)updateProps:(const Props::Shared &)props oldProps:(const Props::Shared & _backedTextInputView.editable = newTextInputProps.traits.editable; } +#if TARGET_OS_OSX // [macOS + // `accessibilityState.disabled` disables the backed text input; `editable={false}` only makes it read-only. + if (newTextInputProps.accessibilityState != oldTextInputProps.accessibilityState) { + _backedTextInputView.enabled = !newTextInputProps.accessibilityState.value_or(AccessibilityState{}).disabled; + } +#endif // macOS] + #if !TARGET_OS_OSX // [macOS] if (newTextInputProps.multiline && newTextInputProps.traits.dataDetectorTypes != oldTextInputProps.traits.dataDetectorTypes) { diff --git a/packages/react-native/React/Fabric/Mounting/ComponentViews/TextInput/RCTTextInputUtils.mm b/packages/react-native/React/Fabric/Mounting/ComponentViews/TextInput/RCTTextInputUtils.mm index b3fe74cbc3cb..b9f9cf4a5e4e 100644 --- a/packages/react-native/React/Fabric/Mounting/ComponentViews/TextInput/RCTTextInputUtils.mm +++ b/packages/react-native/React/Fabric/Mounting/ComponentViews/TextInput/RCTTextInputUtils.mm @@ -33,8 +33,12 @@ void RCTCopyBackedTextInput( toTextInput.accessibilityHelp = fromTextInput.accessibilityHelp; toTextInput.accessibilityIdentifier = fromTextInput.accessibilityIdentifier; toTextInput.accessibilityLabel = fromTextInput.accessibilityLabel; - toTextInput.accessibilityRole = fromTextInput.accessibilityRole; + // An unset role reads back as NSAccessibilityUnknownRole; copying it would hide the new view's default role. + if (![fromTextInput.accessibilityRole isEqualToString:NSAccessibilityUnknownRole]) { + toTextInput.accessibilityRole = fromTextInput.accessibilityRole; + } toTextInput.autoresizingMask = fromTextInput.autoresizingMask; + toTextInput.enabled = fromTextInput.enabled; #endif // macOS] #if TARGET_OS_IOS // [macOS] [visionOS] toTextInput.inputAccessoryView = fromTextInput.inputAccessoryView; diff --git a/packages/react-native/React/Fabric/Mounting/ComponentViews/View/RCTViewComponentView.mm b/packages/react-native/React/Fabric/Mounting/ComponentViews/View/RCTViewComponentView.mm index 4d3f18bffb37..07c6a38f46f6 100644 --- a/packages/react-native/React/Fabric/Mounting/ComponentViews/View/RCTViewComponentView.mm +++ b/packages/react-native/React/Fabric/Mounting/ComponentViews/View/RCTViewComponentView.mm @@ -45,6 +45,189 @@ const CGFloat BACKGROUND_COLOR_ZPOSITION = -1024.0f; +#if TARGET_OS_OSX // [macOS +// The role an accessibility element reports when React Native does not override it. NSControl subclasses, such as the +// NSTextField behind a single-line TextInput, report their role through their cell; the control's own +// `accessibilityRole` getter returns NSAccessibilityUnknownRole until a role is set explicitly. +static NSAccessibilityRole RCTDefaultAccessibilityRoleForElement(NSView *element) +{ + if ([element isKindOfClass:[NSControl class]]) { + NSAccessibilityRole cellRole = ((NSControl *)element).cell.accessibilityRole; + if (cellRole != nil) { + return cellRole; + } + } + return NSAccessibilityUnknownRole; +} + +// Fabric keeps these mappings local instead of depending on Paper's RCTConvert. +static NSAccessibilityRole RCTAccessibilityRoleFromString(NSString *role, BOOL useAriaMappings) +{ + if (useAriaMappings && [role isEqualToString:@"rowgroup"]) { + return nil; + } + + static NSDictionary *ariaRoleToNSAccessibilityRole; + static NSDictionary *traitOrRoleToAccessibilityRole; + static dispatch_once_t onceToken; + dispatch_once(&onceToken, ^{ + ariaRoleToNSAccessibilityRole = @{ + @"alert" : NSAccessibilityGroupRole, + @"alertdialog" : NSAccessibilityGroupRole, + @"application" : NSAccessibilityGroupRole, + @"article" : NSAccessibilityGroupRole, + @"banner" : NSAccessibilityGroupRole, + @"button" : NSAccessibilityButtonRole, + @"cell" : NSAccessibilityCellRole, + @"checkbox" : NSAccessibilityCheckBoxRole, + @"columnheader" : NSAccessibilityCellRole, + @"combobox" : NSAccessibilityComboBoxRole, + @"complementary" : NSAccessibilityGroupRole, + @"contentinfo" : NSAccessibilityGroupRole, + @"definition" : NSAccessibilityGroupRole, + @"dialog" : NSAccessibilityGroupRole, + @"directory" : NSAccessibilityListRole, + @"document" : NSAccessibilityGroupRole, + @"feed" : NSAccessibilityGroupRole, + @"figure" : NSAccessibilityGroupRole, + @"form" : NSAccessibilityGroupRole, + @"grid" : NSAccessibilityTableRole, + @"gridcell" : NSAccessibilityCellRole, + @"group" : NSAccessibilityGroupRole, + @"heading" : NSAccessibilityStaticTextRole, + @"image" : NSAccessibilityImageRole, + @"img" : NSAccessibilityImageRole, + @"link" : NSAccessibilityLinkRole, + @"list" : NSAccessibilityListRole, + @"listbox" : NSAccessibilityListRole, + @"listitem" : NSAccessibilityGroupRole, + @"log" : NSAccessibilityGroupRole, + @"main" : NSAccessibilityGroupRole, + @"marquee" : NSAccessibilityGroupRole, + @"math" : NSAccessibilityGroupRole, + @"menu" : NSAccessibilityMenuRole, + @"menubar" : NSAccessibilityMenuBarRole, + @"menuitem" : NSAccessibilityMenuItemRole, + @"menuitemcheckbox" : NSAccessibilityMenuItemRole, + @"menuitemradio" : NSAccessibilityMenuItemRole, + @"meter" : NSAccessibilityLevelIndicatorRole, + @"navigation" : NSAccessibilityGroupRole, + @"none" : NSAccessibilityGroupRole, + @"note" : NSAccessibilityGroupRole, + @"option" : NSAccessibilityStaticTextRole, + @"presentation" : NSAccessibilityGroupRole, + @"progressbar" : NSAccessibilityProgressIndicatorRole, + @"radio" : NSAccessibilityRadioButtonRole, + @"radiogroup" : NSAccessibilityRadioGroupRole, + @"region" : NSAccessibilityGroupRole, + @"row" : NSAccessibilityRowRole, + @"rowheader" : NSAccessibilityCellRole, + @"scrollbar" : NSAccessibilityScrollBarRole, + @"search" : NSAccessibilityGroupRole, + @"searchbox" : NSAccessibilityTextFieldRole, + @"separator" : NSAccessibilitySplitterRole, + @"slider" : NSAccessibilitySliderRole, + @"spinbutton" : NSAccessibilityIncrementorRole, + @"status" : NSAccessibilityGroupRole, + @"switch" : NSAccessibilityCheckBoxRole, + @"tab" : NSAccessibilityRadioButtonRole, + @"table" : NSAccessibilityTableRole, + @"tablist" : NSAccessibilityTabGroupRole, + @"tabpanel" : NSAccessibilityGroupRole, + @"term" : NSAccessibilityGroupRole, + @"textbox" : NSAccessibilityTextFieldRole, + @"timer" : NSAccessibilityGroupRole, + @"toolbar" : NSAccessibilityToolbarRole, + @"tooltip" : NSAccessibilityGroupRole, + @"tree" : NSAccessibilityOutlineRole, + @"treegrid" : NSAccessibilityTableRole, + @"treeitem" : NSAccessibilityRowRole, + }; + traitOrRoleToAccessibilityRole = @{ + @"adjustable" : NSAccessibilitySliderRole, + @"alert" : NSAccessibilityStaticTextRole, + @"button" : NSAccessibilityButtonRole, + @"checkbox" : NSAccessibilityCheckBoxRole, + @"combobox" : NSAccessibilityComboBoxRole, + @"header" : NSAccessibilityStaticTextRole, + @"image" : NSAccessibilityImageRole, + @"imagebutton" : NSAccessibilityButtonRole, + @"keyboardkey" : NSAccessibilityButtonRole, + @"link" : NSAccessibilityLinkRole, + @"menu" : NSAccessibilityMenuRole, + @"menubar" : NSAccessibilityMenuBarRole, + @"menuitem" : NSAccessibilityMenuItemRole, + @"none" : NSAccessibilityUnknownRole, + @"progressbar" : NSAccessibilityProgressIndicatorRole, + @"radio" : NSAccessibilityRadioButtonRole, + @"radiogroup" : NSAccessibilityRadioGroupRole, + @"scrollbar" : NSAccessibilityScrollBarRole, + @"search" : NSAccessibilityTextFieldRole, + @"spinbutton" : NSAccessibilityIncrementorRole, + @"summary" : NSAccessibilityStaticTextRole, + @"switch" : NSAccessibilityCheckBoxRole, + @"tab" : NSAccessibilityButtonRole, + @"tablist" : NSAccessibilityTabGroupRole, + @"text" : NSAccessibilityStaticTextRole, + @"textbox" : NSAccessibilityTextFieldRole, + @"timer" : NSAccessibilityStaticTextRole, + @"toolbar" : NSAccessibilityToolbarRole, + @"disclosure" : NSAccessibilityDisclosureTriangleRole, + @"group" : NSAccessibilityGroupRole, + @"list" : NSAccessibilityListRole, + @"popupbutton" : NSAccessibilityPopUpButtonRole, + @"menubutton" : NSAccessibilityMenuButtonRole, + @"table" : NSAccessibilityTableRole, + }; + }); + + NSAccessibilityRole accessibilityRole = + useAriaMappings ? ariaRoleToNSAccessibilityRole[role] : traitOrRoleToAccessibilityRole[role]; + if (accessibilityRole == nil && useAriaMappings) { + accessibilityRole = traitOrRoleToAccessibilityRole[role]; + } + return accessibilityRole ?: NSAccessibilityUnknownRole; +} + +// Matches Paper (`-[RCTViewManager updateAccessibilityRole:withDefaultView:]`): `role` takes precedence over +// `accessibilityRole`, and the element's default role is used when neither is set. +static NSAccessibilityRole RCTAccessibilityRoleFromViewProps(const ViewProps &props, NSView *element) +{ + if (props.role != Role::None) { + return RCTAccessibilityRoleFromString(RCTNSStringFromString(toString(props.role)), YES); + } + if (!props.accessibilityRole.empty()) { + return RCTAccessibilityRoleFromString(RCTNSStringFromString(props.accessibilityRole), NO); + } + NSAccessibilityRole traitsRole = + RCTAccessibilityRoleFromTraits(RCTUIAccessibilityTraitsFromAccessibilityTraits(props.accessibilityTraits)); + if (![traitsRole isEqualToString:NSAccessibilityUnknownRole]) { + return traitsRole; + } + return RCTDefaultAccessibilityRoleForElement(element); +} + +// Setting an NSAccessibility state property makes AppKit advertise that attribute, so like Paper +// (`-[RCTView isAccessibilitySelectorAllowed:]`) only expose a state when JS provides it. `disabled` and `selected` are +// plain bools in `AccessibilityState`, so they count as provided whenever `accessibilityState` is set. +static BOOL RCTViewPropsProvideAccessibilityEnabled(const ViewProps &props) +{ + const auto traits = RCTUIAccessibilityTraitsFromAccessibilityTraits(props.accessibilityTraits); + return props.accessibilityState.has_value() || (traits & RCTUIAccessibilityTraitNotEnabled) != 0; +} + +static BOOL RCTViewPropsProvideAccessibilitySelected(const ViewProps &props) +{ + const auto traits = RCTUIAccessibilityTraitsFromAccessibilityTraits(props.accessibilityTraits); + return props.accessibilityState.has_value() || (traits & RCTUIAccessibilityTraitSelected) != 0; +} + +static BOOL RCTViewPropsProvideAccessibilityExpanded(const ViewProps &props) +{ + return props.accessibilityState.has_value() && props.accessibilityState->expanded.has_value(); +} +#endif // macOS] + @implementation RCTViewComponentView { RCTPlatformColor *_backgroundColor; // [macOS] CALayer *_backgroundColorLayer; @@ -516,19 +699,45 @@ - (void)updateProps:(const Props::Shared &)props oldProps:(const Props::Shared & } } +#if !TARGET_OS_OSX // [macOS] // `accessibilityTraits` if (oldViewProps.accessibilityTraits != newViewProps.accessibilityTraits) { -#if !TARGET_OS_OSX // [macOS] self.accessibilityElement.accessibilityTraits = RCTUIAccessibilityTraitsFromAccessibilityTraits(newViewProps.accessibilityTraits); + } #else // [macOS - // On macOS, accessibilityElement returns self (NSView*) which doesn't have accessibilityTraits. - // Set role directly on self based on traits. - RCTUIAccessibilityTraits traits = RCTUIAccessibilityTraitsFromAccessibilityTraits(newViewProps.accessibilityTraits); - self.accessibilityRole = RCTAccessibilityRoleFromTraits(traits); - self.accessibilityEnabled = (traits & RCTUIAccessibilityTraitNotEnabled) == 0; -#endif // macOS] + // `role`, `accessibilityRole` and `accessibilityTraits` + // NSAccessibility has no traits, so all three resolve to a single role on the accessibility element. + // Role props can change without accessibilityTraits changing, so check all three. + if (oldViewProps.role != newViewProps.role || oldViewProps.accessibilityRole != newViewProps.accessibilityRole || + oldViewProps.accessibilityTraits != newViewProps.accessibilityTraits) { + self.accessibilityElement.accessibilityRole = + RCTAccessibilityRoleFromViewProps(newViewProps, self.accessibilityElement); + } + + // `accessibilityState` + // `disabled` and `selected` can also come from the NotEnabled and Selected traits. Only update a state that is, or + // was, provided so that elements without it do not start advertising it. + if (oldViewProps.accessibilityState != newViewProps.accessibilityState || + oldViewProps.accessibilityTraits != newViewProps.accessibilityTraits) { + const auto accessibilityState = newViewProps.accessibilityState.value_or(AccessibilityState{}); + const auto traits = RCTUIAccessibilityTraitsFromAccessibilityTraits(newViewProps.accessibilityTraits); + if (RCTViewPropsProvideAccessibilityEnabled(newViewProps) || + RCTViewPropsProvideAccessibilityEnabled(oldViewProps)) { + self.accessibilityElement.accessibilityEnabled = + !accessibilityState.disabled && (traits & RCTUIAccessibilityTraitNotEnabled) == 0; + } + if (RCTViewPropsProvideAccessibilitySelected(newViewProps) || + RCTViewPropsProvideAccessibilitySelected(oldViewProps)) { + self.accessibilityElement.accessibilitySelected = + accessibilityState.selected || (traits & RCTUIAccessibilityTraitSelected) != 0; + } + if (RCTViewPropsProvideAccessibilityExpanded(newViewProps) || + RCTViewPropsProvideAccessibilityExpanded(oldViewProps)) { + self.accessibilityElement.accessibilityExpanded = accessibilityState.expanded.value_or(false); + } } +#endif // macOS] #if !TARGET_OS_OSX // [macOS] // `accessibilityState` @@ -1714,6 +1923,23 @@ - (BOOL)isAccessibilityElement return [super isAccessibilityElement]; } +#if TARGET_OS_OSX // [macOS +- (BOOL)isAccessibilitySelectorAllowed:(SEL)selector +{ + const auto &props = static_cast(*_props); + if (selector == @selector(isAccessibilityEnabled)) { + return RCTViewPropsProvideAccessibilityEnabled(props); + } + if (selector == @selector(isAccessibilitySelected)) { + return RCTViewPropsProvideAccessibilitySelected(props); + } + if (selector == @selector(isAccessibilityExpanded)) { + return RCTViewPropsProvideAccessibilityExpanded(props); + } + return [super isAccessibilitySelectorAllowed:selector]; +} +#endif // macOS] + - (NSString *)accessibilityValue { const auto &props = static_cast(*_props); diff --git a/packages/react-native/React/Views/RCTViewManager.m b/packages/react-native/React/Views/RCTViewManager.m index 8b3e94644d9d..0ec065ec37a9 100644 --- a/packages/react-native/React/Views/RCTViewManager.m +++ b/packages/react-native/React/Views/RCTViewManager.m @@ -353,6 +353,10 @@ - (void) updateAccessibilityRole:(RCTView *)view withDefaultView:(RCTView *)defa NSMutableDictionary *newState = [NSMutableDictionary new]; if (!state) { +#if TARGET_OS_OSX // [macOS + // Removing the prop must clear the previous state, e.g. so a TextInput is re-enabled once `disabled` goes away. + view.reactAccessibilityElement.accessibilityState = nil; +#endif // macOS] return; } diff --git a/packages/rn-tester/RNTester/AppDelegate.mm b/packages/rn-tester/RNTester/AppDelegate.mm index d069bb0980e2..f2fc24a1a0bc 100644 --- a/packages/rn-tester/RNTester/AppDelegate.mm +++ b/packages/rn-tester/RNTester/AppDelegate.mm @@ -76,6 +76,8 @@ - (void)applicationDidFinishLaunching:(NSNotification *)notification backing:NSBackingStoreBuffered defer:NO]; self.window.title = @"RNTesterApp"; + // Match RCTAppDelegate so Tab and Shift+Tab move between React Native views. + self.window.autorecalculatesKeyViewLoop = YES; NSDictionary *launchOptions = [notification userInfo]; #endif // macOS] diff --git a/packages/rn-tester/js/examples/Accessibility/AccessibilityExample.js b/packages/rn-tester/js/examples/Accessibility/AccessibilityExample.js index 7064fd2395e3..c82e92263ac6 100644 --- a/packages/rn-tester/js/examples/Accessibility/AccessibilityExample.js +++ b/packages/rn-tester/js/examples/Accessibility/AccessibilityExample.js @@ -2229,6 +2229,96 @@ function AriaHiddenExample(): React.Node { ); } +// [macOS +// Exercise macOS-specific role mappings on a View; 'none' clears the role and restores its default. +const macOSSpecificRoles: $ReadOnlyArray< + 'menuitem' | 'option' | 'tab' | 'none', +> = ['menuitem', 'option', 'tab', 'none']; + +function MacOSAccessibilityRoleExample(): React.Node { + const [roleIndex, setRoleIndex] = useState(0); + const selectedRole = macOSSpecificRoles[roleIndex]; + return ( + + + role="menuitem" (AXMenuItem) + + + role="option" (AXStaticText) + + + role="tab" (AXRadioButton) + + + accessibilityRole="textbox" (AXTextField) + + + {`role="${selectedRole}"`} + + +