Skip to main content
Version: 0.61

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โ€‹


Reference

Propsโ€‹

onPressโ€‹

Handler to be called when the user taps the button

TypeRequired
functionYes

titleโ€‹

Text to display inside the button

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)

TypeRequired
colorNo

disabledโ€‹

If true, disable all interactions for this component.

TypeRequired
boolNo

testIDโ€‹

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

TypeRequired
stringNo

hasTVPreferredFocusโ€‹

(Apple TV only) TV preferred focus (see documentation for the View component).

TypeRequiredPlatform
boolNoiOS

nextFocusDownโ€‹

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

TypeRequiredPlatform
numberNoAndroid

nextFocusForwardโ€‹

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

TypeRequiredPlatform
numberNoAndroid

nextFocusLeftโ€‹

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

TypeRequiredPlatform
numberNoAndroid

nextFocusRightโ€‹

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

TypeRequiredPlatform
numberNoAndroid

nextFocusUpโ€‹

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

TypeRequiredPlatform
numberNoAndroid

touchSoundDisabledโ€‹

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

TypeRequiredPlatform
booleanNoAndroid