跳到主要内容

TouchableWithoutFeedback

提示

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

除非你有非常充分的理由,否则不要使用。所有响应按压的元素在触摸时都应该有视觉反馈。

TouchableWithoutFeedback 仅支持一个子元素。如果您希望有多个子组件,请将它们包裹在一个 View 中。重要的是,TouchableWithoutFeedback 通过克隆其子元素并向其应用 responder 属性来工作。因此,任何中间组件都必须将这些属性传递给底层的 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 将告诉视图即使开启了颜色反转也不要被反转。

参见 无障碍指南 获取更多信息。

类型
布尔值

accessible

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

类型
布尔值

accessibilityLabel

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

类型
字符串

accessibilityLanguage
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: 布尔值,selected: 布尔值,checked: 布尔值 或 'mixed', busy: 布尔值,expanded: 布尔值}

accessibilityActions

无障碍动作允许辅助技术以编程方式调用组件的动作。accessibilityActions 属性应包含一个动作对象列表。每个动作对象应包含字段 name 和 label。

参见 无障碍指南 获取更多信息。

类型
数组

aria-busy

指示元素正在被修改,辅助技术可能希望等待更改完成后再告知用户更新。

类型默认值
布尔值false

aria-checked

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

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

aria-disabled

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

类型默认值
布尔值false

aria-expanded

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

类型默认值
布尔值false

aria-hidden

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

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

类型默认值
布尔值false

aria-label

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

类型
字符串

aria-live
Android

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

  • off 无障碍服务不应宣布对此视图的更改。
  • polite 无障碍服务应宣布对此视图的更改。
  • assertive 无障碍服务应中断正在进行的语音以立即宣布对此视图的更改。
类型默认值
枚举 ('assertive', 'off', 'polite')'off'

aria-modal
iOS

布尔值,指示 VoiceOver 是否应忽略接收器兄弟视图内的元素。优先于 accessibilityViewIsModal 属性。

类型默认值
布尔值false

aria-selected

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

类型
布尔值

onAccessibilityAction

当用户执行无障碍动作时调用。此函数的唯一参数是包含要执行的动作名称的事件。

参见 无障碍指南 获取更多信息。

类型
函数

accessibilityValue

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

参见 无障碍指南 获取更多信息。

类型
对象:{min: 数字,max: 数字,now: 数字,text: 字符串}

aria-valuemax

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

类型
数字

aria-valuemin

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

类型
数字

aria-valuenow

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

类型
数字

aria-valuetext

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

类型
字符串

delayLongPress

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

类型
数字

delayPressIn

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

类型
数字

delayPressOut

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

类型
数字

disabled

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

类型
布尔值

hitSlop

这定义了你的触摸可以从按钮开始多远。当移出按钮时,这会添加到 pressRetentionOffset

备注

触摸区域永远不会超出父视图边界,如果触摸命中两个重叠视图,兄弟视图的 Z-index 始终优先。

类型
Rect 或 数字

id

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

类型
字符串

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,触摸时不播放系统声音。

类型
布尔值