Skip to main content
Version: 0.63

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#

onPress#

Handler to be called when the user taps the button. The first function argument is an event in form of PressEvent.

TypeRequired
functionYes

title#

Text to display inside the button. On Android the given title will be converted to the uppercased form.

TypeRequired
stringYes

accessibilityLabel#

Text to display for blindness accessibility features.

TypeRequired
stringNo

color#

Color of the text (iOS), or background color of the button (Android).

TypeRequiredDefault
colorNo`'#2196F3'`
Android

'#007AFF'
iOS

disabled#

If true, disable all interactions for this component.

TypeRequiredDefault
boolNofalse

hasTVPreferredFocus
TV
#

TV preferred focus.

TypeRequiredDefault
boolNofalse

nextFocusDown
Android
TV
#

Designates the next view to receive focus when the user navigates down. See the Android documentation.

TypeRequired
numberNo

nextFocusForward
Android
TV
#

Designates the next view to receive focus when the user navigates forward. See the Android documentation.

TypeRequired
numberNo

nextFocusLeft
Android
TV
#

Designates the next view to receive focus when the user navigates left. See the Android documentation.

TypeRequired
numberNo

nextFocusRight
Android
TV
#

Designates the next view to receive focus when the user navigates right. See the Android documentation.

TypeRequired
numberNo

nextFocusUp
Android
TV
#

Designates the next view to receive focus when the user navigates up. See the Android documentation.

TypeRequired
numberNo

testID#

Used to locate this view in end-to-end tests.

TypeRequired
stringNo

touchSoundDisabled
Android
#

If true, doesn't play system sound on touch.

TypeRequiredDefault
booleanNofalse