跳到主要内容

TouchableNativeFeedback

提示

如果您正在寻找一种更广泛、更具前瞻性的触摸输入处理方式,请查看Pressable API。

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

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

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

示例


参考

属性

TouchableWithoutFeedback Props

继承TouchableWithoutFeedback 属性


background

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

类型
backgroundPropType

useForeground

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

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

类型
布尔值

hasTVPreferredFocus
Android

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

类型
布尔值

nextFocusDown
Android

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

类型
数字

nextFocusForward
Android

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

类型
数字

nextFocusLeft
Android

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

类型
数字

nextFocusRight
Android

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

类型
数字

nextFocusUp
Android

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

类型
数字

方法

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;

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

参数

姓名类型必需描述
颜色字符串涟漪颜色
borderless布尔值涟漪是否可以在其边界之外渲染
rippleRadius?number控制涟漪效果的半径

canUseNativeForeground()

tsx
static canUseNativeForeground(): boolean;