跳到主要内容

TouchableWithoutFeedback

提示

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

除非有非常充分的理由,否则请勿使用此组件。所有响应按压操作的元素都应在被触碰时提供视觉反馈。

TouchableWithoutFeedback 只支持一个子组件。如果您希望有多个子组件,请将它们封装在一个 View 中。重要的是,TouchableWithoutFeedback 通过克隆其子组件并向其应用响应者 props 来工作。因此,任何中间组件都必须将这些 props 传递给底层的 React Native 组件。

使用模式

tsx
function MyComponent(props: MyComponentProps) {
return (
<View {...props} style={{flex: 1, backgroundColor: '#fff'}}>
<Text>My Component</Text>
</View>
);
}

<TouchableWithoutFeedback onPress={() => alert('Pressed!')}>
<MyComponent />
</TouchableWithoutFeedback>;

示例


参考

属性

accessibilityIgnoresInvertColors
iOS

一个值,表示当颜色反转开启时,此视图是否应该反转。值为 true 将告诉视图即使颜色反转开启也不要反转。

有关更多信息,请参阅无障碍指南

类型
Boolean

accessible

当为 true 时,表示该视图是一个无障碍元素。默认情况下,所有可触控元素都可访问。

类型
布尔值

accessibilityLabel

当用户与元素交互时,覆盖屏幕阅读器读取的文本。默认情况下,标签是通过遍历所有子元素并累积所有由空格分隔的 Text 节点来构建的。

类型
字符串

无障碍语言
iOS

指示屏幕阅读器在用户与元素交互时应使用的语言值。它应遵循 BCP 47 规范

有关更多信息,请参阅 iOS accessibilityLanguage 文档

类型
字符串

accessibilityHint

无障碍提示可帮助用户了解当他们在无障碍元素上执行操作时会发生什么,如果该结果无法从无障碍标签中清楚得知。

类型
字符串

accessibilityRole

accessibilityRole 向辅助技术用户传达组件的用途。

accessibilityRole 可以是以下之一

  • 'none' - 当元素没有角色时使用。
  • 'button' - 当元素应被视为按钮时使用。
  • 'link' - 当元素应被视为链接时使用。
  • 'search' - 当文本字段元素也应被视为搜索字段时使用。
  • 'image' - 当元素应被视为图像时使用。例如,可以与按钮或链接结合使用。
  • 'keyboardkey' - 当元素充当键盘键时使用。
  • 'text' - 当元素应被视为不可更改的静态文本时使用。
  • 'adjustable' - 当元素可以“调整”(例如滑块)时使用。
  • 'imagebutton' - 当元素应被视为按钮且同时是图像时使用。
  • 'header' - 当元素充当内容部分的标题(例如导航栏的标题)时使用。
  • 'summary' - 当应用程序首次启动时,可用于提供应用程序当前状况的快速摘要的元素。
  • 'alert' - 当元素包含重要文本需要呈现给用户时使用。
  • 'checkbox' - 当元素表示一个复选框时,它可以被选中、未选中或处于混合选中状态。
  • 'combobox' - 当元素表示一个组合框时,它允许用户从多个选项中进行选择。
  • 'menu' - 当组件是选项菜单时使用。
  • 'menubar' - 当组件是多个菜单的容器时使用。
  • 'menuitem' - 用于表示菜单中的一个项目。
  • 'progressbar' - 用于表示一个指示任务进度的组件。
  • 'radio' - 用于表示一个单选按钮。
  • 'radiogroup' - 用于表示一组单选按钮。
  • 'scrollbar' - 用于表示一个滚动条。
  • 'spinbutton' - 用于表示一个打开选择列表的按钮。
  • 'switch' - 用于表示一个可以打开和关闭的开关。
  • 'tab' - 用于表示一个标签页。
  • 'tablist' - 用于表示一个标签页列表。
  • 'timer' - 用于表示一个计时器。
  • 'toolbar' - 用于表示一个工具栏(操作按钮或组件的容器)。
类型
字符串

accessibilityState

向辅助技术用户描述组件的当前状态。

有关更多信息,请参阅无障碍指南

类型
对象: {disabled: bool, selected: bool, checked: bool 或 'mixed', busy: bool, expanded: bool}

accessibilityActions

辅助功能操作允许辅助技术以编程方式调用组件的操作。accessibilityActions 属性应包含操作对象的列表。每个操作对象应包含字段名和标签。

有关更多信息,请参阅辅助功能指南

类型
数组

aria-busy

表示元素正在被修改,辅助技术可能需要等待更改完成才能将更新通知用户。

类型默认
布尔值false

aria-checked

指示可检查元素的状态。此字段可以接受布尔值或“mixed”字符串来表示混合复选框。

类型默认
布尔值,'mixed'false

aria-disabled

表示元素可感知但已禁用,因此不可编辑或以其他方式操作。

类型默认
布尔值false

aria-expanded

指示可展开元素当前是展开还是折叠。

类型默认
布尔值false

aria-hidden

表示元素是否对辅助技术隐藏。

例如,在一个包含兄弟视图 AB 的窗口中,将视图 Baria-hidden 设置为 true 会导致 VoiceOver 忽略 B 元素及其子元素。

类型默认
布尔值false

aria-label

定义一个标记交互元素的字符串值。

类型
字符串

aria-live
Android

表示元素将被更新,并描述用户代理、辅助技术和用户可以从实时区域期望的更新类型。

  • off 辅助服务不应宣布此视图的更改。
  • polite 辅助服务应宣布此视图的更改。
  • assertive 辅助服务应中断正在进行的语音,立即宣布此视图的更改。
类型默认
enum('assertive', 'off', 'polite')'off'

aria-modal
iOS

布尔值,表示 VoiceOver 是否应忽略接收者兄弟视图中的元素。优先于 accessibilityViewIsModal prop。

类型默认
布尔值false

aria-selected

指示可选元素当前是否已选中。

类型
布尔值

onAccessibilityAction

当用户执行辅助功能操作时调用。此函数唯一的参数是一个事件,其中包含要执行的操作的名称。

有关更多信息,请参阅辅助功能指南

类型
函数

accessibilityValue

表示组件的当前值。它可以是组件值的文本描述,或者对于基于范围的组件(如滑块和进度条),它包含范围信息(最小值、当前值和最大值)。

有关更多信息,请参阅无障碍指南

类型
对象: {min: number, max: number, now: number, text: string}

aria-valuemax

表示基于范围的组件(如滑块和进度条)的最大值。优先于 accessibilityValue prop 中的 max 值。

类型
数字

aria-valuemin

表示基于范围的组件(如滑块和进度条)的最小值。优先于 accessibilityValue prop 中的 min 值。

类型
数字

aria-valuenow

表示基于范围的组件(如滑块和进度条)的当前值。优先于 accessibilityValue prop 中的 now 值。

类型
数字

aria-valuetext

表示组件的文本描述。优先于 accessibilityValue prop 中的 text 值。

类型
字符串

delayLongPress

onPressIn 调用到 onLongPress 被调用之间的持续时间(毫秒)。

类型
数字

delayPressIn

从触摸开始到 onPressIn 被调用之间的持续时间(毫秒)。

类型
数字

delayPressOut

从触摸释放到 onPressOut 被调用之间的持续时间(毫秒)。

类型
数字

disabled

如果为 true,则禁用此组件的所有交互。

类型
布尔值

hitSlop

这定义了您的触摸可以从按钮开始的最大距离。当从按钮上移开时,此值会添加到 pressRetentionOffset 中。

注意

触摸区域永远不会超出父视图边界,并且如果触摸到两个重叠视图,兄弟视图的 Z 轴顺序始终优先。

类型
Rect 或数字

id

用于从原生代码定位此视图。优先于 nativeID prop。

类型
字符串

onBlur

项目失去焦点时调用。

类型
({nativeEvent: TargetEvent}) => void

onFocus

项目获得焦点时调用。

类型
({nativeEvent: TargetEvent}) => void

onLayout

在挂载和布局更改时调用。

类型
({nativeEvent: LayoutEvent}) => void

onLongPress

如果 onPressIn 之后的时间超过 370 毫秒,则调用此函数。此时间段可以使用 delayLongPress 进行自定义。

类型
函数

onPress

触摸释放时调用,但如果被取消(例如,通过抢占响应者锁的滚动)则不调用。第一个函数参数是 PressEvent 形式的事件。

类型
函数

onPressIn

触摸元素被按下后立即调用,甚至在 onPress 之前调用。这在进行网络请求时可能很有用。第一个函数参数是 PressEvent 形式的事件。

类型
函数

onPressOut

触摸释放后立即调用,甚至在 onPress 之前调用。第一个函数参数是 PressEvent 形式的事件。

类型
函数

pressRetentionOffset

当滚动视图被禁用时,这定义了您的触摸在按钮停用之前可以从按钮上移动的距离。一旦停用,尝试将其移回,您会看到按钮再次被激活!当滚动视图被禁用时,多次来回移动它。确保传入一个常量以减少内存分配。

类型
Rect 或数字

nativeID

类型
字符串

testID

用于在端到端测试中定位此视图。

类型
字符串

touchSoundDisabled
Android

如果为 true,则触摸时不会播放系统声音。

类型
Boolean