TouchableNativeFeedback
A wrapper for making views respond properly to touches (Android only). On Android this component uses native state drawable to display touch feedback.
At the moment it only supports having a single View instance as a child node, as it's implemented by replacing that View with another instance of RCTView node with some additional properties set.
Background drawable of native feedback touchable can be customized with background property.
Example
import React, {useState} from 'react';
import {Text, View, StyleSheet, TouchableNativeFeedback} from 'react-native';
import {SafeAreaView, SafeAreaProvider} from 'react-native-safe-area-context';
const App = () => {
const [rippleColor, setRippleColor] = useState(randomHexColor());
const [rippleOverflow, setRippleOverflow] = useState(false);
return (
<SafeAreaProvider>
<SafeAreaView style={styles.container}>
<TouchableNativeFeedback
onPress={() => {
setRippleColor(randomHexColor());
setRippleOverflow(!rippleOverflow);
}}
background={TouchableNativeFeedback.Ripple(
rippleColor,
rippleOverflow,
)}>
<View style={styles.touchable}>
<Text style={styles.text}>TouchableNativeFeedback</Text>
</View>
</TouchableNativeFeedback>
</SafeAreaView>
</SafeAreaProvider>
);
};
const randomHexColor = () => {
return '#000000'.replace(/0/g, function () {
return Math.round(Math.random() * 16).toString(16);
});
};
const styles = StyleSheet.create({
container: {
flex: 1,
justifyContent: 'center',
backgroundColor: 'black',
paddingHorizontal: 20,
},
touchable: {
flex: 0.33,
justifyContent: 'center',
backgroundColor: '#eeeeee',
borderColor: 'black',
borderWidth: 1,
},
text: {
alignSelf: 'center',
},
});
export default App;
Reference
Props
TouchableWithoutFeedback Props
Inherits TouchableWithoutFeedback Props.
background
Determines the type of background drawable that's going to be used to display feedback.
| Type |
|---|
| backgroundPropType |
useForeground
Set to true to add the ripple effect to the foreground of the view, instead of the background.
| Type |
|---|
| bool |
hasTVPreferredFocus Android
TV preferred focus.
| Type |
|---|
| bool |
nextFocusDown Android
TV next focus down.
| Type |
|---|
| number |
nextFocusForward Android
TV next focus forward.
| Type |
|---|
| number |
nextFocusLeft Android
TV next focus left.
| Type |
|---|
| number |
nextFocusRight Android
TV next focus right.
| Type |
|---|
| number |
nextFocusUp Android
TV next focus up.
| Type |
|---|
| number |
Methods
SelectableBackground()
static SelectableBackground(
rippleRadius: number | null,
): ThemeAttributeBackgroundPropType;
Creates an object that represents android theme's default background for selectable elements.
SelectableBackgroundBorderless()
static SelectableBackgroundBorderless(
rippleRadius: number | null,
): ThemeAttributeBackgroundPropType;
Creates an object that represent android theme's default background for borderless selectable elements. Available on android API level 21+.
Ripple()
static Ripple(
color: ColorValue,
borderless: boolean,
rippleRadius?: number | null,
): RippleBackgroundPropType;
Creates an object that represents ripple drawable with specified color. Available on Android API level 21+.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
| color | string | Yes | The ripple color |
| borderless | boolean | Yes | If the ripple can render outside its bounds |
| rippleRadius | number | No | controls the radius of the ripple effect |
canUseNativeForeground()
static canUseNativeForeground(): boolean;
Last updated: Jul 07, 2026
