跳到主要内容
版本:0.77

TouchableNativeFeedback

如果你正在寻找一种更广泛且面向未来的方式来处理基于触摸的输入,请查看 Pressable API。

一个使视图能够正确响应触摸的包装器(仅限 Android)。在 Android 上,此组件使用原生状态可绘制对象来显示触摸反馈。

目前它仅支持将单个 View 实例作为子节点,因为它是通过用另一个设置了一些额外属性的 RCTView 节点实例替换该 View 来实现的。

原生反馈触摸器的背景可绘制对象可以通过 background 属性进行自定义。

示例


参考

属性

TouchableWithoutFeedback 属性

继承 TouchableWithoutFeedback 属性


background

确定将用于显示反馈的背景可绘制对象的类型。它接受一个带有 type 属性的对象,以及取决于 type 的额外数据。建议使用其中一种静态方法来生成该字典。

类型
backgroundPropType

useForeground

设置为 true 可将涟漪效果添加到视图的前景而不是背景。如果你的某个子视图有自己的背景,或者你例如正在显示图像,并且你不希望涟漪被它们覆盖,这很有用。

首先检查 TouchableNativeFeedback.canUseNativeForeground(),因为这仅在 Android 6.0 及以上版本可用。如果你尝试在旧版本上使用此功能,你将收到警告并回退到背景。

类型
bool

hasTVPreferredFocus
Android

TV 首选焦点(参见 View 组件的文档)。

类型
bool

nextFocusDown
Android

TV 下一个向下焦点(参见 View 组件的文档)。

类型
number

nextFocusForward
Android

TV 下一个向前焦点(参见 View 组件的文档)。

类型
number

nextFocusLeft
Android

TV 下一个向左焦点(参见 View 组件的文档)。

类型
number

nextFocusRight
Android

TV 下一个向右焦点(参见 View 组件的文档)。

类型
number

nextFocusUp
Android

TV 下一个向上焦点(参见 View 组件的文档)。

类型
number

方法

SelectableBackground()

tsx
static SelectableBackground(
rippleRadius: number | null,
): ThemeAttributeBackgroundPropType;

创建一个对象,表示安卓主题默认可选择元素的背景(?android:attr/selectableItemBackground)。rippleRadius 参数控制涟漪效果的半径。


SelectableBackgroundBorderless()

tsx
static SelectableBackgroundBorderless(
rippleRadius: number | null,
): ThemeAttributeBackgroundPropType;

创建一个对象,表示安卓主题默认无边框可选择元素的背景(?android:attr/selectableItemBackgroundBorderless)。在 Android API 级别 21+ 上可用。rippleRadius 参数控制涟漪效果的半径。


Ripple()

tsx
static Ripple(
color: ColorValue,
borderless: boolean,
rippleRadius?: number | null,
): RippleBackgroundPropType;

创建一个对象,表示具有指定颜色(作为字符串)的涟漪可绘制对象。如果属性 borderless 计算为 true,涟漪将渲染在视图边界之外(参见原生操作栏按钮作为该行为的示例)。此背景类型在 Android API 级别 21+ 上可用。

参数:

名称类型必填描述
colorstring涟漪颜色
borderlessboolean涟漪是否可以渲染到其边界之外
rippleRadius?number控制涟漪效果的半径

canUseNativeForeground()

tsx
static canUseNativeForeground(): boolean;