2017-02-28 05:28:23 +03:00
|
|
|
/**
|
2018-09-12 01:27:47 +03:00
|
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
2017-02-28 05:28:23 +03:00
|
|
|
*
|
2018-02-17 05:24:55 +03:00
|
|
|
* This source code is licensed under the MIT license found in the
|
|
|
|
* LICENSE file in the root directory of this source tree.
|
2017-02-28 05:28:23 +03:00
|
|
|
*
|
2018-05-11 05:06:46 +03:00
|
|
|
* @format
|
2017-02-28 05:28:23 +03:00
|
|
|
* @flow
|
|
|
|
*/
|
2018-05-11 05:06:46 +03:00
|
|
|
|
2017-02-28 05:28:23 +03:00
|
|
|
'use strict';
|
|
|
|
|
2019-05-08 18:44:25 +03:00
|
|
|
const Promise = require('../../Promise');
|
|
|
|
const RCTDeviceEventEmitter = require('../../EventEmitter/RCTDeviceEventEmitter');
|
2017-02-28 05:28:23 +03:00
|
|
|
|
2019-08-09 20:06:53 +03:00
|
|
|
import NativeAccessibilityManager from './NativeAccessibilityManager';
|
|
|
|
|
2019-03-15 21:17:42 +03:00
|
|
|
const CHANGE_EVENT_NAME = {
|
|
|
|
announcementFinished: 'announcementFinished',
|
|
|
|
boldTextChanged: 'boldTextChanged',
|
|
|
|
grayscaleChanged: 'grayscaleChanged',
|
|
|
|
invertColorsChanged: 'invertColorsChanged',
|
|
|
|
reduceMotionChanged: 'reduceMotionChanged',
|
|
|
|
reduceTransparencyChanged: 'reduceTransparencyChanged',
|
|
|
|
screenReaderChanged: 'screenReaderChanged',
|
|
|
|
};
|
2017-02-28 05:28:23 +03:00
|
|
|
|
2019-05-17 00:17:11 +03:00
|
|
|
type ChangeEventName = $Keys<{
|
2018-05-11 05:06:46 +03:00
|
|
|
announcementFinished: string,
|
2019-03-15 21:17:42 +03:00
|
|
|
boldTextChanged: string,
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
change: string,
|
2019-03-15 21:17:42 +03:00
|
|
|
grayscaleChanged: string,
|
|
|
|
invertColorsChanged: string,
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
reduceMotionChanged: string,
|
2019-03-15 21:17:42 +03:00
|
|
|
reduceTransparencyChanged: string,
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
screenReaderChanged: string,
|
2019-11-21 20:38:13 +03:00
|
|
|
...
|
2017-02-28 05:28:23 +03:00
|
|
|
}>;
|
|
|
|
|
2018-03-04 02:04:46 +03:00
|
|
|
const _subscriptions = new Map();
|
2017-02-28 05:28:23 +03:00
|
|
|
|
|
|
|
/**
|
Migrate to new documentation format
Summary:
Now that the Component and API docs are no longer auto-generated, we need to consolidate on a new format for our jsdoc comments. Any help from the community will be appreciated.
In this initial pull request, we'll be tackling the following docs:
- `AccessibilityInfo`, an API doc.
- `ActivityIndicator`, a Component doc.
- `View`, a Component doc.
This top comment will serve as a style guide, and when in doubt, please refer to the individual commits in this PR.
Each commit should update a single component or API, along with any relevant markdown files.
- Documentation in the JavaScript source files should be succinct. Any verbosity should be moved over to the markdown docs in the website...
- ...by adding a link to the relevant method/prop on the website to every comment block.
- Avoid markdown style links in JavaScript source files, opt for plain old URIs.
Let code document itself:
- If a method is Flow typed, the comment block does not need to repeat this information.
- If a param can be one of several values, and the type definition is easily determined from the code, the values should not be repeated in the comment block. Again, move this to the markdown doc if not present already.
Closes https://github.com/facebook/react-native/pull/16790
Differential Revision: D6353840
Pulled By: hramos
fbshipit-source-id: 9712c459acc33092aae9909f3dd0b58a00b26afc
2017-11-17 03:44:29 +03:00
|
|
|
* Sometimes it's useful to know whether or not the device has a screen reader
|
|
|
|
* that is currently active. The `AccessibilityInfo` API is designed for this
|
2018-02-22 18:04:35 +03:00
|
|
|
* purpose. You can use it to query the current state of the screen reader as
|
|
|
|
* well as to register to be notified when the state of the screen reader
|
Migrate to new documentation format
Summary:
Now that the Component and API docs are no longer auto-generated, we need to consolidate on a new format for our jsdoc comments. Any help from the community will be appreciated.
In this initial pull request, we'll be tackling the following docs:
- `AccessibilityInfo`, an API doc.
- `ActivityIndicator`, a Component doc.
- `View`, a Component doc.
This top comment will serve as a style guide, and when in doubt, please refer to the individual commits in this PR.
Each commit should update a single component or API, along with any relevant markdown files.
- Documentation in the JavaScript source files should be succinct. Any verbosity should be moved over to the markdown docs in the website...
- ...by adding a link to the relevant method/prop on the website to every comment block.
- Avoid markdown style links in JavaScript source files, opt for plain old URIs.
Let code document itself:
- If a method is Flow typed, the comment block does not need to repeat this information.
- If a param can be one of several values, and the type definition is easily determined from the code, the values should not be repeated in the comment block. Again, move this to the markdown doc if not present already.
Closes https://github.com/facebook/react-native/pull/16790
Differential Revision: D6353840
Pulled By: hramos
fbshipit-source-id: 9712c459acc33092aae9909f3dd0b58a00b26afc
2017-11-17 03:44:29 +03:00
|
|
|
* changes.
|
2017-02-28 05:28:23 +03:00
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html
|
2017-02-28 05:28:23 +03:00
|
|
|
*/
|
2018-03-04 02:04:46 +03:00
|
|
|
const AccessibilityInfo = {
|
2017-02-28 05:28:23 +03:00
|
|
|
/**
|
2019-03-15 21:17:42 +03:00
|
|
|
* Query whether bold text is currently enabled.
|
2018-02-22 18:04:35 +03:00
|
|
|
*
|
|
|
|
* Returns a promise which resolves to a boolean.
|
2019-03-15 21:17:42 +03:00
|
|
|
* The result is `true` when bold text is enabled and `false` otherwise.
|
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#isBoldTextEnabled
|
2019-03-15 21:17:42 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
isBoldTextEnabled: function(): Promise<boolean> {
|
2019-03-15 21:17:42 +03:00
|
|
|
return new Promise((resolve, reject) => {
|
2019-05-29 23:01:45 +03:00
|
|
|
if (NativeAccessibilityManager) {
|
|
|
|
NativeAccessibilityManager.getCurrentBoldTextState(resolve, reject);
|
|
|
|
} else {
|
|
|
|
reject(reject);
|
|
|
|
}
|
2019-03-15 21:17:42 +03:00
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Query whether grayscale is currently enabled.
|
|
|
|
*
|
|
|
|
* Returns a promise which resolves to a boolean.
|
|
|
|
* The result is `true` when grayscale is enabled and `false` otherwise.
|
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#isGrayscaleEnabled
|
2019-03-15 21:17:42 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
isGrayscaleEnabled: function(): Promise<boolean> {
|
2019-03-15 21:17:42 +03:00
|
|
|
return new Promise((resolve, reject) => {
|
2019-05-29 23:01:45 +03:00
|
|
|
if (NativeAccessibilityManager) {
|
|
|
|
NativeAccessibilityManager.getCurrentGrayscaleState(resolve, reject);
|
|
|
|
} else {
|
|
|
|
reject(reject);
|
|
|
|
}
|
2019-03-15 21:17:42 +03:00
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Query whether inverted colors are currently enabled.
|
|
|
|
*
|
|
|
|
* Returns a promise which resolves to a boolean.
|
|
|
|
* The result is `true` when invert color is enabled and `false` otherwise.
|
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#isInvertColorsEnabled
|
2019-03-15 21:17:42 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
isInvertColorsEnabled: function(): Promise<boolean> {
|
2019-03-15 21:17:42 +03:00
|
|
|
return new Promise((resolve, reject) => {
|
2019-05-29 23:01:45 +03:00
|
|
|
if (NativeAccessibilityManager) {
|
|
|
|
NativeAccessibilityManager.getCurrentInvertColorsState(resolve, reject);
|
|
|
|
} else {
|
|
|
|
reject(reject);
|
|
|
|
}
|
2019-03-15 21:17:42 +03:00
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Query whether reduced motion is currently enabled.
|
|
|
|
*
|
|
|
|
* Returns a promise which resolves to a boolean.
|
|
|
|
* The result is `true` when a reduce motion is enabled and `false` otherwise.
|
2018-02-22 18:04:35 +03:00
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#isReduceMotionEnabled
|
2017-02-28 05:28:23 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
isReduceMotionEnabled: function(): Promise<boolean> {
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
return new Promise((resolve, reject) => {
|
2019-05-29 23:01:45 +03:00
|
|
|
if (NativeAccessibilityManager) {
|
|
|
|
NativeAccessibilityManager.getCurrentReduceMotionState(resolve, reject);
|
|
|
|
} else {
|
|
|
|
reject(reject);
|
|
|
|
}
|
2019-03-15 21:17:42 +03:00
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Query whether reduced transparency is currently enabled.
|
|
|
|
*
|
|
|
|
* Returns a promise which resolves to a boolean.
|
|
|
|
* The result is `true` when a reduce transparency is enabled and `false` otherwise.
|
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#isReduceTransparencyEnabled
|
2019-03-15 21:17:42 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
isReduceTransparencyEnabled: function(): Promise<boolean> {
|
2019-03-15 21:17:42 +03:00
|
|
|
return new Promise((resolve, reject) => {
|
2019-05-29 23:01:45 +03:00
|
|
|
if (NativeAccessibilityManager) {
|
|
|
|
NativeAccessibilityManager.getCurrentReduceTransparencyState(
|
|
|
|
resolve,
|
|
|
|
reject,
|
|
|
|
);
|
|
|
|
} else {
|
|
|
|
reject(reject);
|
|
|
|
}
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
});
|
|
|
|
},
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Query whether a screen reader is currently enabled.
|
|
|
|
*
|
|
|
|
* Returns a promise which resolves to a boolean.
|
|
|
|
* The result is `true` when a screen reader is enabled and `false` otherwise.
|
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#isScreenReaderEnabled
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
isScreenReaderEnabled: function(): Promise<boolean> {
|
2017-02-28 05:28:23 +03:00
|
|
|
return new Promise((resolve, reject) => {
|
2019-05-29 23:01:45 +03:00
|
|
|
if (NativeAccessibilityManager) {
|
|
|
|
NativeAccessibilityManager.getCurrentVoiceOverState(resolve, reject);
|
|
|
|
} else {
|
|
|
|
reject(reject);
|
|
|
|
}
|
2017-02-28 05:28:23 +03:00
|
|
|
});
|
|
|
|
},
|
|
|
|
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
/**
|
|
|
|
* Deprecated
|
|
|
|
*
|
|
|
|
* Same as `isScreenReaderEnabled`
|
|
|
|
*/
|
2019-08-09 20:06:53 +03:00
|
|
|
get fetch(): $FlowFixMe {
|
2019-09-19 04:32:27 +03:00
|
|
|
console.warn(
|
2020-04-04 11:08:04 +03:00
|
|
|
'AccessibilityInfo.fetch is deprecated, call AccessibilityInfo.isScreenReaderEnabled instead',
|
2019-09-19 04:32:27 +03:00
|
|
|
);
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
return this.isScreenReaderEnabled;
|
|
|
|
},
|
|
|
|
|
2017-02-28 05:28:23 +03:00
|
|
|
/**
|
|
|
|
* Add an event handler. Supported events:
|
|
|
|
*
|
2019-03-15 21:17:42 +03:00
|
|
|
* - `boldTextChanged`: iOS-only event. Fires when the state of the bold text toggle changes.
|
|
|
|
* The argument to the event handler is a boolean. The boolean is `true` when a bold text
|
|
|
|
* is enabled and `false` otherwise.
|
|
|
|
* - `grayscaleChanged`: iOS-only event. Fires when the state of the gray scale toggle changes.
|
|
|
|
* The argument to the event handler is a boolean. The boolean is `true` when a gray scale
|
|
|
|
* is enabled and `false` otherwise.
|
|
|
|
* - `invertColorsChanged`: iOS-only event. Fires when the state of the invert colors toggle
|
|
|
|
* changes. The argument to the event handler is a boolean. The boolean is `true` when a invert
|
|
|
|
* colors is enabled and `false` otherwise.
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
* - `reduceMotionChanged`: Fires when the state of the reduce motion toggle changes.
|
|
|
|
* The argument to the event handler is a boolean. The boolean is `true` when a reduce
|
|
|
|
* motion is enabled (or when "Transition Animation Scale" in "Developer options" is
|
|
|
|
* "Animation off") and `false` otherwise.
|
2019-03-15 21:17:42 +03:00
|
|
|
* - `reduceTransparencyChanged`: iOS-only event. Fires when the state of the reduce transparency
|
|
|
|
* toggle changes. The argument to the event handler is a boolean. The boolean is `true`
|
|
|
|
* when a reduce transparency is enabled and `false` otherwise.
|
- Add support for "reduce motion" into AccessibilityInfo (#23839)
Summary:
This PR adds `isReduceMotionEnabled()` to `AccessibilityInfo` in other to add support for "reduce motion", exposing the Operational System's settings option. Additionally, it adds a new event, `reduceMotionChanged`, in order to listen for this flag's update.
With this feature, developers will be able to disable or reduce animations, _**something that will be required as soon as WCAG 2.1 draft got approved**._ See [WCAG 2.1 — 2.3.3 Animations from Interaction criteria](https://knowbility.org/blog/2018/WCAG21-233Animations/)
It's exposed by [`UIAccessibility`' isReduceMotionEnabled ](https://developer.apple.com/documentation/uikit/uiaccessibility/1615133-isreducemotionenabled
) on iOS and [Settings.Global.TRANSITION_ANIMATION_SCALE](https://developer.android.com/reference/android/provider/Settings.Global#TRANSITION_ANIMATION_SCALE) on Android.
Up until now, `AccessibilityInfo` only exposes screen reader flag. By adding this second accessibility option, it's a good opportunity to rename `fetch` method to an appropriate name, `isScreenReaderEnabled`, as well as rename `change` event to `screenReaderChanged`, which will make it clearer and more specific.
(In case it's approved, a follow-up PR could exposes [more iOS acessibility flags](https://developer.apple.com/documentation/uikit/uiaccessibility), such as `isShakeToUndoEnabled`, `isReduceTransparencyEnabled`, `isGrayscaleEnabled`, `isInvertColorsEnabled`)
(iOS code inspired by [phonegap-mobile-accessibility](https://github.com/phonegap/phonegap-mobile-accessibility). And Android by [Flutter](https://github.com/flutter/engine/blob/master/shell/platform/android/io/flutter/view/AccessibilityBridge.java
))
Pull Request resolved: https://github.com/facebook/react-native/pull/23839
Differential Revision: D14406227
Pulled By: hramos
fbshipit-source-id: adf43be84c488522bf1e29d862681220ad193883
2019-03-13 06:23:54 +03:00
|
|
|
* - `screenReaderChanged`: Fires when the state of the screen reader changes. The argument
|
2017-02-28 05:28:23 +03:00
|
|
|
* to the event handler is a boolean. The boolean is `true` when a screen
|
|
|
|
* reader is enabled and `false` otherwise.
|
2017-05-30 14:35:52 +03:00
|
|
|
* - `announcementFinished`: iOS-only event. Fires when the screen reader has
|
Migrate to new documentation format
Summary:
Now that the Component and API docs are no longer auto-generated, we need to consolidate on a new format for our jsdoc comments. Any help from the community will be appreciated.
In this initial pull request, we'll be tackling the following docs:
- `AccessibilityInfo`, an API doc.
- `ActivityIndicator`, a Component doc.
- `View`, a Component doc.
This top comment will serve as a style guide, and when in doubt, please refer to the individual commits in this PR.
Each commit should update a single component or API, along with any relevant markdown files.
- Documentation in the JavaScript source files should be succinct. Any verbosity should be moved over to the markdown docs in the website...
- ...by adding a link to the relevant method/prop on the website to every comment block.
- Avoid markdown style links in JavaScript source files, opt for plain old URIs.
Let code document itself:
- If a method is Flow typed, the comment block does not need to repeat this information.
- If a param can be one of several values, and the type definition is easily determined from the code, the values should not be repeated in the comment block. Again, move this to the markdown doc if not present already.
Closes https://github.com/facebook/react-native/pull/16790
Differential Revision: D6353840
Pulled By: hramos
fbshipit-source-id: 9712c459acc33092aae9909f3dd0b58a00b26afc
2017-11-17 03:44:29 +03:00
|
|
|
* finished making an announcement. The argument to the event handler is a
|
|
|
|
* dictionary with these keys:
|
2017-05-30 14:35:52 +03:00
|
|
|
* - `announcement`: The string announced by the screen reader.
|
Migrate to new documentation format
Summary:
Now that the Component and API docs are no longer auto-generated, we need to consolidate on a new format for our jsdoc comments. Any help from the community will be appreciated.
In this initial pull request, we'll be tackling the following docs:
- `AccessibilityInfo`, an API doc.
- `ActivityIndicator`, a Component doc.
- `View`, a Component doc.
This top comment will serve as a style guide, and when in doubt, please refer to the individual commits in this PR.
Each commit should update a single component or API, along with any relevant markdown files.
- Documentation in the JavaScript source files should be succinct. Any verbosity should be moved over to the markdown docs in the website...
- ...by adding a link to the relevant method/prop on the website to every comment block.
- Avoid markdown style links in JavaScript source files, opt for plain old URIs.
Let code document itself:
- If a method is Flow typed, the comment block does not need to repeat this information.
- If a param can be one of several values, and the type definition is easily determined from the code, the values should not be repeated in the comment block. Again, move this to the markdown doc if not present already.
Closes https://github.com/facebook/react-native/pull/16790
Differential Revision: D6353840
Pulled By: hramos
fbshipit-source-id: 9712c459acc33092aae9909f3dd0b58a00b26afc
2017-11-17 03:44:29 +03:00
|
|
|
* - `success`: A boolean indicating whether the announcement was
|
|
|
|
* successfully made.
|
2018-02-22 18:04:35 +03:00
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#addeventlistener
|
2017-02-28 05:28:23 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
addEventListener: function(
|
2017-02-28 05:28:23 +03:00
|
|
|
eventName: ChangeEventName,
|
2018-05-11 05:06:46 +03:00
|
|
|
handler: Function,
|
2017-02-28 05:28:23 +03:00
|
|
|
): Object {
|
2018-03-04 02:04:46 +03:00
|
|
|
let listener;
|
2017-05-30 14:35:52 +03:00
|
|
|
|
2019-03-15 21:17:42 +03:00
|
|
|
if (eventName === 'change') {
|
2017-05-30 14:35:52 +03:00
|
|
|
listener = RCTDeviceEventEmitter.addListener(
|
2019-03-15 21:17:42 +03:00
|
|
|
CHANGE_EVENT_NAME.screenReaderChanged,
|
2018-05-11 05:06:46 +03:00
|
|
|
handler,
|
2017-05-30 14:35:52 +03:00
|
|
|
);
|
2019-03-15 21:17:42 +03:00
|
|
|
} else if (CHANGE_EVENT_NAME[eventName]) {
|
|
|
|
listener = RCTDeviceEventEmitter.addListener(eventName, handler);
|
2017-05-30 14:35:52 +03:00
|
|
|
}
|
|
|
|
|
2017-02-28 05:28:23 +03:00
|
|
|
_subscriptions.set(handler, listener);
|
|
|
|
return {
|
2018-05-11 05:06:46 +03:00
|
|
|
remove: AccessibilityInfo.removeEventListener.bind(
|
|
|
|
null,
|
|
|
|
eventName,
|
|
|
|
handler,
|
|
|
|
),
|
2017-02-28 05:28:23 +03:00
|
|
|
};
|
|
|
|
},
|
|
|
|
|
2017-05-26 13:07:49 +03:00
|
|
|
/**
|
Migrate to new documentation format
Summary:
Now that the Component and API docs are no longer auto-generated, we need to consolidate on a new format for our jsdoc comments. Any help from the community will be appreciated.
In this initial pull request, we'll be tackling the following docs:
- `AccessibilityInfo`, an API doc.
- `ActivityIndicator`, a Component doc.
- `View`, a Component doc.
This top comment will serve as a style guide, and when in doubt, please refer to the individual commits in this PR.
Each commit should update a single component or API, along with any relevant markdown files.
- Documentation in the JavaScript source files should be succinct. Any verbosity should be moved over to the markdown docs in the website...
- ...by adding a link to the relevant method/prop on the website to every comment block.
- Avoid markdown style links in JavaScript source files, opt for plain old URIs.
Let code document itself:
- If a method is Flow typed, the comment block does not need to repeat this information.
- If a param can be one of several values, and the type definition is easily determined from the code, the values should not be repeated in the comment block. Again, move this to the markdown doc if not present already.
Closes https://github.com/facebook/react-native/pull/16790
Differential Revision: D6353840
Pulled By: hramos
fbshipit-source-id: 9712c459acc33092aae9909f3dd0b58a00b26afc
2017-11-17 03:44:29 +03:00
|
|
|
* Set accessibility focus to a react component.
|
2018-02-22 18:04:35 +03:00
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#setaccessibilityfocus
|
2017-05-26 13:07:49 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
setAccessibilityFocus: function(reactTag: number): void {
|
2019-05-29 23:01:45 +03:00
|
|
|
if (NativeAccessibilityManager) {
|
|
|
|
NativeAccessibilityManager.setAccessibilityFocus(reactTag);
|
|
|
|
}
|
2017-05-26 13:07:49 +03:00
|
|
|
},
|
|
|
|
|
2017-05-30 14:35:52 +03:00
|
|
|
/**
|
Migrate to new documentation format
Summary:
Now that the Component and API docs are no longer auto-generated, we need to consolidate on a new format for our jsdoc comments. Any help from the community will be appreciated.
In this initial pull request, we'll be tackling the following docs:
- `AccessibilityInfo`, an API doc.
- `ActivityIndicator`, a Component doc.
- `View`, a Component doc.
This top comment will serve as a style guide, and when in doubt, please refer to the individual commits in this PR.
Each commit should update a single component or API, along with any relevant markdown files.
- Documentation in the JavaScript source files should be succinct. Any verbosity should be moved over to the markdown docs in the website...
- ...by adding a link to the relevant method/prop on the website to every comment block.
- Avoid markdown style links in JavaScript source files, opt for plain old URIs.
Let code document itself:
- If a method is Flow typed, the comment block does not need to repeat this information.
- If a param can be one of several values, and the type definition is easily determined from the code, the values should not be repeated in the comment block. Again, move this to the markdown doc if not present already.
Closes https://github.com/facebook/react-native/pull/16790
Differential Revision: D6353840
Pulled By: hramos
fbshipit-source-id: 9712c459acc33092aae9909f3dd0b58a00b26afc
2017-11-17 03:44:29 +03:00
|
|
|
* Post a string to be announced by the screen reader.
|
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#announceforaccessibility
|
2017-05-30 14:35:52 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
announceForAccessibility: function(announcement: string): void {
|
2019-05-29 23:01:45 +03:00
|
|
|
if (NativeAccessibilityManager) {
|
|
|
|
NativeAccessibilityManager.announceForAccessibility(announcement);
|
|
|
|
}
|
2017-05-30 14:35:52 +03:00
|
|
|
},
|
|
|
|
|
2017-02-28 05:28:23 +03:00
|
|
|
/**
|
|
|
|
* Remove an event handler.
|
2018-02-22 18:04:35 +03:00
|
|
|
*
|
2020-02-25 00:06:47 +03:00
|
|
|
* See https://reactnative.dev/docs/accessibilityinfo.html#removeeventlistener
|
2017-02-28 05:28:23 +03:00
|
|
|
*/
|
2020-03-25 07:35:58 +03:00
|
|
|
removeEventListener: function(
|
2017-02-28 05:28:23 +03:00
|
|
|
eventName: ChangeEventName,
|
2018-05-11 05:06:46 +03:00
|
|
|
handler: Function,
|
2017-02-28 05:28:23 +03:00
|
|
|
): void {
|
2018-03-04 02:04:46 +03:00
|
|
|
const listener = _subscriptions.get(handler);
|
2017-02-28 05:28:23 +03:00
|
|
|
if (!listener) {
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
listener.remove();
|
|
|
|
_subscriptions.delete(handler);
|
|
|
|
},
|
|
|
|
};
|
|
|
|
|
|
|
|
module.exports = AccessibilityInfo;
|