跳到主要内容

TouchableNativeFeedback

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

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

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

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

示例


参考

Props

TouchableWithoutFeedback Props

继承 TouchableWithoutFeedback Props


background

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

类型
backgroundPropType

useForeground

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

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

类型
bool

hasTVPreferredFocus
Android

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

类型
bool

nextFocusDown
Android

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

类型
number

nextFocusForward
Android

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

类型
number

nextFocusLeft
Android

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

类型
number

nextFocusRight
Android

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

类型
number

nextFocusUp
Android

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

类型
number

Methods

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 level 21+ 上可用。 rippleRadius 参数控制波纹效果的半径。


Ripple()

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

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

参数

名称类型必需描述
colorstring波纹颜色
borderlessboolean如果波纹可以在其边界之外渲染
rippleRadius?number控制波纹效果的半径

canUseNativeForeground()

tsx
static canUseNativeForeground(): boolean;