diff --git a/docs/accessibility.md b/docs/accessibility.md index c5cef7e2324..6d969725882 100644 --- a/docs/accessibility.md +++ b/docs/accessibility.md @@ -14,18 +14,20 @@ Android and iOS differ slightly in their approaches, and thus the React Native i ### `accessible` -When `true`, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component. By default, all touchable elements are accessible. +When `true`, indicates that the view is discoverable by assistive technologies such as screen readers and hardware keyboards. Note that this does not necessarily mean that the view will be focused by VoiceOver or TalkBack. There are a number of reasons for this, such as VoiceOver disallowing nested acecssibility elements, or TalkBack opting to focus some parent element instead. -On Android, `accessible={true}` property for a react-native View will be translated into native `focusable={true}`. +By default, all touchable elements are accessible. + +On Android, `accessible` will be translated into native [`focusable`](). On iOS, it translates into native [`isAccessibilityElement`](https://developer.apple.com/documentation/uikit/uiaccessibilityelement/isaccessibilityelement?language=objc). ```tsx - - text one - text two + + + ``` -In the above example, accessibility focus is only available on the parent view with the `accessible` property, and not individually for 'text one' and 'text two'. +In the above example, accessibility focus is only available on the first child view with the `accessible` property, and not for the parent or sibling without `accessible`. ### `accessibilityLabel` diff --git a/docs/view.md b/docs/view.md index e39540d43e0..8f60e598171 100644 --- a/docs/view.md +++ b/docs/view.md @@ -206,7 +206,9 @@ See the [Accessibility guide](accessibility.md#accessibilityviewismodal-ios) for ### `accessible` -When `true`, indicates that the view is an accessibility element. By default, all the touchable elements are accessible. +When `true`, indicates that the view is an accessibility element and discoverable by assistive technologies such as screen readers and hardware keyboards. By default, all the touchable elements are accessible. + +See the [Accessibility guide](accessibility.md#accessible) for more information. --- diff --git a/website/versioned_docs/version-0.78/accessibility.md b/website/versioned_docs/version-0.78/accessibility.md index 33e1708e43e..9359fabaa4e 100644 --- a/website/versioned_docs/version-0.78/accessibility.md +++ b/website/versioned_docs/version-0.78/accessibility.md @@ -14,18 +14,20 @@ Android and iOS differ slightly in their approaches, and thus the React Native i ### `accessible` -When `true`, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component. By default, all touchable elements are accessible. +When `true`, indicates that the view is discoverable by assistive technologies such as screen readers and hardware keyboards. Note that this does not necessarily mean that the view will be focused by VoiceOver or TalkBack. There are a number of reasons for this, such as VoiceOver disallowing nested acecssibility elements, or TalkBack opting to focus some parent element instead. -On Android, `accessible={true}` property for a react-native View will be translated into native `focusable={true}`. +By default, all touchable elements are accessible. + +On Android, `accessible` will be translated into native [`focusable`](). On iOS, it translates into native [`isAccessibilityElement`](https://developer.apple.com/documentation/uikit/uiaccessibilityelement/isaccessibilityelement?language=objc). ```tsx - - text one - text two + + + ``` -In the above example, accessibility focus is only available on the parent view with the `accessible` property, and not individually for 'text one' and 'text two'. +In the above example, accessibility focus is only available on the first child view with the `accessible` property, and not for the parent or sibling without `accessible`. ### `accessibilityLabel` diff --git a/website/versioned_docs/version-0.78/view.md b/website/versioned_docs/version-0.78/view.md index e39540d43e0..8f60e598171 100644 --- a/website/versioned_docs/version-0.78/view.md +++ b/website/versioned_docs/version-0.78/view.md @@ -206,7 +206,9 @@ See the [Accessibility guide](accessibility.md#accessibilityviewismodal-ios) for ### `accessible` -When `true`, indicates that the view is an accessibility element. By default, all the touchable elements are accessible. +When `true`, indicates that the view is an accessibility element and discoverable by assistive technologies such as screen readers and hardware keyboards. By default, all the touchable elements are accessible. + +See the [Accessibility guide](accessibility.md#accessible) for more information. --- diff --git a/website/versioned_docs/version-0.79/accessibility.md b/website/versioned_docs/version-0.79/accessibility.md index 33e1708e43e..9359fabaa4e 100644 --- a/website/versioned_docs/version-0.79/accessibility.md +++ b/website/versioned_docs/version-0.79/accessibility.md @@ -14,18 +14,20 @@ Android and iOS differ slightly in their approaches, and thus the React Native i ### `accessible` -When `true`, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component. By default, all touchable elements are accessible. +When `true`, indicates that the view is discoverable by assistive technologies such as screen readers and hardware keyboards. Note that this does not necessarily mean that the view will be focused by VoiceOver or TalkBack. There are a number of reasons for this, such as VoiceOver disallowing nested acecssibility elements, or TalkBack opting to focus some parent element instead. -On Android, `accessible={true}` property for a react-native View will be translated into native `focusable={true}`. +By default, all touchable elements are accessible. + +On Android, `accessible` will be translated into native [`focusable`](). On iOS, it translates into native [`isAccessibilityElement`](https://developer.apple.com/documentation/uikit/uiaccessibilityelement/isaccessibilityelement?language=objc). ```tsx - - text one - text two + + + ``` -In the above example, accessibility focus is only available on the parent view with the `accessible` property, and not individually for 'text one' and 'text two'. +In the above example, accessibility focus is only available on the first child view with the `accessible` property, and not for the parent or sibling without `accessible`. ### `accessibilityLabel` diff --git a/website/versioned_docs/version-0.79/view.md b/website/versioned_docs/version-0.79/view.md index e39540d43e0..8f60e598171 100644 --- a/website/versioned_docs/version-0.79/view.md +++ b/website/versioned_docs/version-0.79/view.md @@ -206,7 +206,9 @@ See the [Accessibility guide](accessibility.md#accessibilityviewismodal-ios) for ### `accessible` -When `true`, indicates that the view is an accessibility element. By default, all the touchable elements are accessible. +When `true`, indicates that the view is an accessibility element and discoverable by assistive technologies such as screen readers and hardware keyboards. By default, all the touchable elements are accessible. + +See the [Accessibility guide](accessibility.md#accessible) for more information. --- diff --git a/website/versioned_docs/version-0.80/accessibility.md b/website/versioned_docs/version-0.80/accessibility.md index c5cef7e2324..6d969725882 100644 --- a/website/versioned_docs/version-0.80/accessibility.md +++ b/website/versioned_docs/version-0.80/accessibility.md @@ -14,18 +14,20 @@ Android and iOS differ slightly in their approaches, and thus the React Native i ### `accessible` -When `true`, indicates that the view is an accessibility element. When a view is an accessibility element, it groups its children into a single selectable component. By default, all touchable elements are accessible. +When `true`, indicates that the view is discoverable by assistive technologies such as screen readers and hardware keyboards. Note that this does not necessarily mean that the view will be focused by VoiceOver or TalkBack. There are a number of reasons for this, such as VoiceOver disallowing nested acecssibility elements, or TalkBack opting to focus some parent element instead. -On Android, `accessible={true}` property for a react-native View will be translated into native `focusable={true}`. +By default, all touchable elements are accessible. + +On Android, `accessible` will be translated into native [`focusable`](). On iOS, it translates into native [`isAccessibilityElement`](https://developer.apple.com/documentation/uikit/uiaccessibilityelement/isaccessibilityelement?language=objc). ```tsx - - text one - text two + + + ``` -In the above example, accessibility focus is only available on the parent view with the `accessible` property, and not individually for 'text one' and 'text two'. +In the above example, accessibility focus is only available on the first child view with the `accessible` property, and not for the parent or sibling without `accessible`. ### `accessibilityLabel` diff --git a/website/versioned_docs/version-0.80/view.md b/website/versioned_docs/version-0.80/view.md index e39540d43e0..8f60e598171 100644 --- a/website/versioned_docs/version-0.80/view.md +++ b/website/versioned_docs/version-0.80/view.md @@ -206,7 +206,9 @@ See the [Accessibility guide](accessibility.md#accessibilityviewismodal-ios) for ### `accessible` -When `true`, indicates that the view is an accessibility element. By default, all the touchable elements are accessible. +When `true`, indicates that the view is an accessibility element and discoverable by assistive technologies such as screen readers and hardware keyboards. By default, all the touchable elements are accessible. + +See the [Accessibility guide](accessibility.md#accessible) for more information. ---