跳至主要内容

TouchableNativeFeedback

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

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

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

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

示例


参考

属性

TouchableWithoutFeedback 属性

继承 TouchableWithoutFeedback 属性


background

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

类型
backgroundPropType

useForeground

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

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

类型
布尔值

hasTVPreferredFocus
Android

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

类型
布尔值

nextFocusDown
Android

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

类型
数字

nextFocusForward
Android

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

类型
数字

nextFocusLeft
Android

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

类型
数字

nextFocusRight
Android

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

类型
数字

nextFocusUp
Android

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

类型
数字

方法

SelectableBackground()

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

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


SelectableBackgroundBorderless()

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

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


Ripple()

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

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

参数

名称类型必填描述
color字符串波纹颜色
borderless布尔值波纹是否可以在其边界之外渲染
rippleRadius?数字控制波纹效果的半径

canUseNativeForeground()

static canUseNativeForeground(): boolean;