TouchableNativeFeedback

提示

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

一个用于让视图正确响应触摸的包装组件（仅限 Android）。在 Android 上，这个组件使用原生状态 drawable 来显示触摸反馈。

目前它只支持将单个 View 实例作为子节点，因为它的实现方式是用另一个带有一些额外属性设置的 RCTView 节点替换该 View。

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

Example

---

Reference

Props

TouchableWithoutFeedback Props

继承自 TouchableWithoutFeedback Props。

---

background

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

Type
backgroundPropType

---

useForeground

设置为 true 时，将涟漪效果添加到视图的前景，而不是背景。如果你的某个子视图本身有背景，或者你正在显示图片，并且不希望涟漪被它们遮住，这会很有用。

请先检查 TouchableNativeFeedback.canUseNativeForeground()，因为这仅适用于 Android 6.0 及以上版本。如果你在旧版本上尝试使用它，会收到警告并回退到背景模式。

Type
bool

---

hasTVPreferredFocus

Android

TV 首选焦点（参见 View 组件的文档）。

Type
bool

---

nextFocusDown

Android

TV 下一个焦点向下（参见 View 组件的文档）。

Type
number

---

nextFocusForward

Android

TV 下一个焦点向前（参见 View 组件的文档）。

Type
number

---

nextFocusLeft

Android

TV 下一个焦点向左（参见 View 组件的文档）。

Type
number

---

nextFocusRight

Android

TV 下一个焦点向右（参见 View 组件的文档）。

Type
number

---

nextFocusUp

Android

TV 下一个焦点向上（参见 View 组件的文档）。

Type
number

Methods

SelectableBackground()

React TSX

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

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

---

SelectableBackgroundBorderless()

React TSX

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

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

---

Ripple()

React TSX

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

创建一个表示指定颜色（字符串形式）涟漪 drawable 的对象。如果属性 borderless 的值为 true，涟漪将会在视图边界之外渲染（例如原生 actionbar 按钮的行为）。此背景类型适用于 Android API 级别 21 及以上。

Parameters:

Name	Type	Required	Description
color	string	Yes	涟漪颜色
borderless	boolean	Yes	涟漪是否可以在其边界之外渲染
rippleRadius	?number	No	控制涟漪效果的半径

---

canUseNativeForeground()

React TSX

static canUseNativeForeground(): boolean;