跳到主要内容

TouchableWithoutFeedback

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

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

TouchableWithoutFeedback 仅支持一个子组件。如果您希望有多个子组件,请将它们包裹在 View 中。重要的是,TouchableWithoutFeedback 通过克隆其子组件并将响应器属性应用于它来工作。因此,任何中间组件都必须将这些属性传递给底层的 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 时,表示该视图是一个无障碍元素。默认情况下,所有可触摸的元素都是可访问的。

类型
bool

accessibilityLabel

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

类型
string

accessibilityLanguage
iOS

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

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

类型
string

accessibilityHint

无障碍提示帮助用户理解当他们对无障碍元素执行操作时会发生什么,如果结果从无障碍标签中不清楚的话。

类型
string

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' - 用于表示工具栏(操作按钮或组件的容器)。
类型
string

accessibilityState

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

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

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

accessibilityActions

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

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

类型
array

aria-busy

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

类型默认
booleanfalse

aria-checked

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

类型默认
boolean, 'mixed'false

aria-disabled

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

类型默认
booleanfalse

aria-expanded

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

类型默认
booleanfalse

aria-hidden

指示此无障碍元素中包含的无障碍元素是否隐藏。

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

类型默认
booleanfalse

aria-label

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

类型
string

aria-live
Android

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

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

aria-modal
iOS

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

类型默认
booleanfalse

aria-selected

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

类型
boolean

onAccessibilityAction

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

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

类型
function

accessibilityValue

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

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

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

aria-valuemax

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

类型
number

aria-valuemin

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

类型
number

aria-valuenow

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

类型
number

aria-valuetext

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

类型
string

delayLongPress

onPressIn 到调用 onLongPress 的持续时间(以毫秒为单位)。

类型
number

delayPressIn

从触摸开始到调用 onPressIn 的持续时间(以毫秒为单位)。

类型
number

delayPressOut

从释放触摸到调用 onPressOut 的持续时间(以毫秒为单位)。

类型
number

disabled

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

类型
bool

hitSlop

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

触摸区域永远不会超出父视图边界,如果触摸击中两个重叠的视图,则同级视图的 Z 索引始终优先。

类型
Rect 或 number

id

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

类型
string

onBlur

当项目失去焦点时调用。

类型
function

onFocus

当项目获得焦点时调用。

类型
function

onLayout

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

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

onLongPress

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

类型
function

onPress

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

类型
function

onPressIn

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

类型
function

onPressOut

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

类型
function

pressRetentionOffset

当禁用滚动视图时,这将定义您的触摸在停用按钮之前可以离开按钮多远。停用后,尝试将其移回,您将看到按钮再次激活!在禁用滚动视图时,来回移动几次。确保传入常量以减少内存分配。

类型
Rect 或 number

nativeID

类型
string

testID

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

类型
string

touchSoundDisabled
Android

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

类型
Boolean