In some cases, we also want to alert the end user of the type of selected component (i.e., that it is a “button”). If we were using native buttons, this would work automatically. Since we are using javascript, we need to provide a bit more context for TalkBack. To do so, you must specify the ‘accessibilityComponentType’ property for any UI component. For instances, we support ‘button’, ‘radiobutton_checked’ and ‘radiobutton_unchecked’ and so on.
A Boolean value indicating whether the accessibility elements contained within this accessibility element are hidden to the screen reader.
Overrides the text that's read by the screen reader when the user interacts with the element. By default, the label is constructed by traversing all the children and accumulating all the Text nodes separated by space.
Indicates to accessibility services whether the user should be notified when this view changes. Works for Android API >= 19 only. See http://developer.android.com/reference/android/view/View.html#attr_android:accessibilityLiveRegion for references.
Accessibility traits tell a person using VoiceOver what kind of element they have selected. Is this element a label? A button? A header? These questions are answered by accessibilityTraits.
When true, indicates that the view is an accessibility element. By default, all the touchable elements are accessible.
Specifies whether font should be scaled down automatically to fit given style constraints.
Specifies whether fonts should scale to respect Text Size accessibility settings.
The default is true
.
This can be one of the following values:
head
- The line is displayed so that the end fits in the container and the missing text
at the beginning of the line is indicated by an ellipsis glyph. e.g., "...wxyz"middle
- The line is displayed so that the beginning and end fit in the container and the
missing text in the middle is indicated by an ellipsis glyph. "ab...yz"tail
- The line is displayed so that the beginning fits in the container and the
missing text at the end of the line is indicated by an ellipsis glyph. e.g., "abcd..."clip
- Lines are not drawn past the edge of the text container.The default is tail
.
numberOfLines
must be set in conjunction with this prop.
clip
is working only for iOS
Controls how view is important for accessibility which is if it fires accessibility events and if it is reported to accessibility services that query the screen. Works for Android only. See http://developer.android.com/reference/android/R.attr.html#importantForAccessibility for references.
Possible values: 'auto' - The system determines whether the view is important for accessibility - default (recommended). 'yes' - The view is important for accessibility. 'no' - The view is not important for accessibility. 'no-hide-descendants' - The view is not important for accessibility, nor are any of its descendant views.
Displays text as a react-native paper Caption component
Displays text as a react-native paper Headline component
Displays text as a react-native paper Paragraph component
Displays text as a react-native paper Subheading component
Displays text as a react-native paper Title component
Line Break mode. Works only with numberOfLines. clip is working only for iOS
Optional color for the link. Default is 'blue'. See also onPressUrlTarget
Specifies smallest possible scale a font can reach when adjustsFontSizeToFit is enabled. (values 0.01-1.0).
Used to truncate the text with an ellipsis after computing the text layout, including line wrapping, such that the total number of lines does not exceed this number.
This prop is commonly used with ellipsizeMode
.
When accessible
is true, the system will try to invoke this function when the user performs accessibility tap gesture.
Invoked on mount and layout changes with
{nativeEvent: { layout: {x, y, width, height}}}.
This function is called on long press.
e.g., onLongPress={this.increaseSize}>`
When accessible is true, the system will invoke this function when the user performs the magic tap gesture.
This function is called on press. Text intrinsically supports press handling with a default highlight state (which can be disabled with suppressHighlighting).
An url to open when user clicks the label. Styles the label as a clickable "link"
Lets the user select text, to use the native copy and paste functionality.
The highlight color of the text.
When true
, no visual change is made when text is pressed down. By
default, a gray oval highlights the text on press down.
Used to locate this view in end-to-end tests.
Set text break strategy on Android API Level 23+
default is highQuality
.
Properties for the CrossLabel component. Control component type using isTitle, isCaption, isHeadline, isSubheading and isParagraph.
Create an URL link using onPressUrlTarget and customize color using linkColor.
Inherits react-native Text's TextProps