Button
A basic button component that should render nicely on any platform. Supports a minimal level of customization.
If this button doesn't look right for your app, you can build your own button using TouchableOpacity or TouchableWithoutFeedback. For inspiration, look at the source code for this button component. Or, take a look at the wide variety of button components built by the community.
<Button onPress={onPressLearnMore} title="Learn More" color="#841584" accessibilityLabel="Learn more about this purple button"/>Example#
Reference
Props#
RequiredonPress#
Handler to be called when the user taps the button.
| Type |
|---|
| function(PressEvent) |
Requiredtitle#
Text to display inside the button. On Android the given title will be converted to the uppercased form.
| Type |
|---|
| string |
accessibilityLabel#
Text to display for blindness accessibility features.
| Type |
|---|
| string |
color#
Color of the text (iOS), or background color of the button (Android).
| Type | Default |
|---|---|
| color | `'#2196F3'` Android '#007AFF' iOS |
disabled#
If true, disable all interactions for this component.
| Type | Default |
|---|---|
| bool | false |
hasTVPreferredFocus TV#
TV preferred focus.
| Type | Default |
|---|---|
| bool | false |
nextFocusDown AndroidTV#
Designates the next view to receive focus when the user navigates down. See the Android documentation.
| Type |
|---|
| number |
nextFocusForward AndroidTV#
Designates the next view to receive focus when the user navigates forward. See the Android documentation.
| Type |
|---|
| number |
nextFocusLeft AndroidTV#
Designates the next view to receive focus when the user navigates left. See the Android documentation.
| Type |
|---|
| number |
nextFocusRight AndroidTV#
Designates the next view to receive focus when the user navigates right. See the Android documentation.
| Type |
|---|
| number |
nextFocusUp AndroidTV#
Designates the next view to receive focus when the user navigates up. See the Android documentation.
| Type |
|---|
| number |
testID#
Used to locate this view in end-to-end tests.
| Type |
|---|
| string |
touchSoundDisabled Android#
If true, doesn't play system sound on touch.
| Type | Default |
|---|---|
| boolean | false |