跳到主要内容
版本:0.80

TouchableNativeFeedback

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

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

目前它仅支持将单个 View 实例作为子节点,因为它是通过将该 View 替换为另一个具有某些附加属性的 RCTView 节点实例来实现的。

原生反馈触摸的背景 drawable 可以通过 background 属性自定义。

示例


参考

属性

TouchableWithoutFeedback 属性

继承 TouchableWithoutFeedback 属性


background

确定将用于显示反馈的背景 drawable 类型。它接受一个带有 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 主题的可选择元素默认背景(?android:attr/selectableItemBackground)。rippleRadius 参数控制涟漪效果的半径。


SelectableBackgroundBorderless()

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

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


Ripple()

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

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

参数:

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

canUseNativeForeground()

tsx
static canUseNativeForeground(): boolean;