TouchableWithoutFeedback

如果您正在寻找更全面且更具未来性的处理基于触摸的输入的方法，请查看 Pressable API。

除非有充分的理由，否则请勿使用。所有响应按压的元素在触摸时都应有视觉反馈。

TouchableWithoutFeedback 仅支持一个子元素。如果您希望有多个子组件，请将它们包装在 View 中。重要的是，TouchableWithoutFeedback 通过克隆其子元素并将响应者属性应用于它来工作。因此，要求任何中间组件将这些属性传递给底层的 React Native 组件。

使用模式

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

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

示例

参考

属性

`accessibilityIgnoresInvertColors`

类型
布尔值

`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 属性应包含操作对象的列表。每个操作对象都应包含字段名称和标签。

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

类型
数组

`aria-busy`

指示元素正在被修改，并且辅助技术可能希望等到更改完成之后再向用户通知更新。

类型	默认值
布尔值	false

`aria-checked`

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

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

`aria-disabled`

指示元素是可感知的但被禁用的，因此它不可编辑或无法操作。

类型	默认值
布尔值	false

`aria-expanded`

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

类型	默认值
布尔值	false

`aria-hidden`

指示此辅助功能元素中包含的辅助功能元素是否隐藏。

例如，在一个包含同级视图 A 和 B 的窗口中，在视图 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 索引始终优先。

类型
矩形或数字

`id`

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

类型
字符串

`onBlur`

当项目失去焦点时调用。

类型
函数

`onFocus`

当项目获得焦点时调用。

类型
函数

`onLayout`

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

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

`onLongPress`

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

类型
函数

`onPress`

当触摸释放时调用，但如果取消（例如，通过窃取响应者锁定的滚动）则不会调用。第一个函数参数是一个 PressEvent 形式的事件。

类型
函数

`onPressIn`

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

类型
函数

`onPressOut`

只要触摸释放就调用，甚至在 onPress 之前调用。第一个函数参数是一个 PressEvent 形式的事件。

类型
函数

`pressRetentionOffset`

当滚动视图被禁用时，这定义了您的触摸可以在按钮上移动多远，然后才能停用按钮。停用后，尝试将其移回，您会发现按钮再次被激活！在滚动视图被禁用时，将其前后移动几次。确保传递一个常量以减少内存分配。

类型
矩形或数字

`nativeID`

类型
字符串

`testID`

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

类型
字符串

`touchSoundDisabled`
Android

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

类型
布尔值

使用模式​

示例​

参考

属性​

accessibilityIgnoresInvertColors​

accessible​

accessibilityLabel​

accessibilityLanguage iOS​

accessibilityHint​

accessibilityRole​

accessibilityState​

accessibilityActions​

aria-busy​

aria-checked​

aria-disabled​

aria-expanded​

aria-hidden​

aria-label​

aria-live Android​

aria-modal iOS​

aria-selected​

onAccessibilityAction​

accessibilityValue​

aria-valuemax​

aria-valuemin​

aria-valuenow​

aria-valuetext​

delayLongPress​

delayPressIn​

delayPressOut​

disabled​

hitSlop​

id​

onBlur​

onFocus​

onLayout​

onLongPress​

onPress​

onPressIn​

onPressOut​

pressRetentionOffset​

nativeID​

testID​

touchSoundDisabled Android​

使用模式

示例

属性

`accessibilityIgnoresInvertColors`

`accessible`

`accessibilityLabel`

`accessibilityLanguage`
iOS

`accessibilityHint`

`accessibilityRole`

`accessibilityState`

`accessibilityActions`

`aria-busy`

`aria-checked`

`aria-disabled`

`aria-expanded`

`aria-hidden`

`aria-label`

`aria-live`
Android

`aria-modal`
iOS

`aria-selected`

`onAccessibilityAction`

`accessibilityValue`

`aria-valuemax`

`aria-valuemin`

`aria-valuenow`

`aria-valuetext`

`delayLongPress`

`delayPressIn`

`delayPressOut`

`disabled`

`hitSlop`

`id`

`onBlur`

`onFocus`

`onLayout`

`onLongPress`

`onPress`

`onPressIn`

`onPressOut`

`pressRetentionOffset`

`nativeID`

`testID`

`touchSoundDisabled`
Android