跳到主要内容
版本:0.78

TouchableNativeFeedback

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

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

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

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

示例​


参考

属性​

TouchableWithoutFeedback 属性​

继承 TouchableWithoutFeedback 属性。


background​

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

类型
backgroundPropType

useForeground​

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

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

类型
bool

hasTVPreferredFocus
安卓
​

电视首选焦点(参见 View 组件文档)。

类型
bool

nextFocusDown
安卓
​

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

类型
number

nextFocusForward
安卓
​

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

类型
number

nextFocusLeft
安卓
​

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

类型
number

nextFocusRight
安卓
​

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

类型
number

nextFocusUp
安卓
​

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

类型
number

方法​

SelectableBackground()​

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

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


SelectableBackgroundBorderless()​

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

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


Ripple()​

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

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

参数:

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

canUseNativeForeground()​

React TSX
static canUseNativeForeground(): boolean;