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 TouchableNativeFeedback. 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.
Example usage:
import { Button } from 'react-native';
...
<Button
onPress={onPressLearnMore}
title="Learn More"
color="#841584"
accessibilityLabel="Learn more about this purple button"
/>
Props
accessibilityLabelcolordisabledhasTVPreferredFocusnextFocusDownnextFocusForwardnextFocusLeftnextFocusRightnextFocusUponPresstestIDtitletouchSoundDisabled
Reference
Props
onPress
Handler to be called when the user taps the button
| Type | Required |
|---|---|
| function | Yes |
title
Text to display inside the button
| Type | Required |
|---|---|
| string | Yes |
accessibilityLabel
Text to display for blindness accessibility features
| Type | Required |
|---|---|
| string | No |
color
Color of the text (iOS), or background color of the button (Android)
| Type | Required |
|---|---|
| color | No |
disabled
If true, disable all interactions for this component.
| Type | Required |
|---|---|
| bool | No |
testID
Used to locate this view in end-to-end tests.
| Type | Required |
|---|---|
| string | No |
hasTVPreferredFocus
(Apple TV only) TV preferred focus (see documentation for the View component).
| Type | Required | Platform |
|---|---|---|
| bool | No | iOS |
nextFocusDown
Designates the next view to receive focus when the user navigates down. See the Android documentation.
| Type | Required | Platform |
|---|---|---|
| number | No | Android |
nextFocusForward
Designates the next view to receive focus when the user navigates forward. See the Android documentation.
| Type | Required | Platform |
|---|---|---|
| number | No | Android |
nextFocusLeft
Designates the next view to receive focus when the user navigates left. See the Android documentation.
| Type | Required | Platform |
|---|---|---|
| number | No | Android |
nextFocusRight
Designates the next view to receive focus when the user navigates right. See the Android documentation.
| Type | Required | Platform |
|---|---|---|
| number | No | Android |
nextFocusUp
Designates the next view to receive focus when the user navigates up. See the Android documentation.
| Type | Required | Platform |
|---|---|---|
| number | No | Android |
touchSoundDisabled
If true, doesn't play system sound on touch.
| Type | Required | Platform |
|---|---|---|
| boolean | No | Android |