版本：0.82

TouchableWithoutFeedback

提示

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

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

TouchableWithoutFeedback 只支持一个子元素。如果你希望有多个子组件，请将它们包裹在一个 View 中。重要的是，TouchableWithoutFeedback 的工作方式是克隆其子元素并将 responder props 应用到它上面。因此，任何中间组件都必须将这些 props 传递给底层的 React Native 组件。

使用模式

React TSX
function MyComponent(props: MyComponentProps) {
  return (
    <View {...props} style={{flex: 1, backgroundColor: '#fff'}}>
      <Text>我的组件</Text>
    </View>
  );
}

<TouchableWithoutFeedback onPress={() => alert('已按下！')}>
  <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' - 用于元素应被视为图像时。例如可与 button 或 link 组合使用。
'keyboardkey' - 用于元素充当键盘按键时。
'text' - 用于元素应被视为不可更改的静态文本时。
'adjustable' - 用于元素可以被“调整”时（例如滑块）。
'imagebutton' - 用于元素应被视为按钮且同时也是图像时。
'header' - 用于元素充当内容区段标题时（例如导航栏标题）。
'summary' - 用于应用首次启动时，元素可用于提供当前状态的快速摘要。
'alert' - 用于元素包含应向用户呈现的重要文本时。
'checkbox' - 用于元素表示一个可勾选、取消勾选或处于混合勾选状态的复选框时。
'combobox' - 用于元素表示一个组合框，允许用户从多个选项中选择时。
'menu' - 用于组件是一个选项菜单时。
'menubar' - 用于组件是多个菜单的容器时。
'menuitem' - 用于表示菜单中的一项时。
'progressbar' - 用于表示指示任务进度的组件时。
'radio' - 用于表示单选按钮时。
'radiogroup' - 用于表示一组单选按钮时。
'scrollbar' - 用于表示滚动条时。
'spinbutton' - 用于表示打开选项列表的按钮时。
'switch' - 用于表示可开启和关闭的开关时。
'tab' - 用于表示选项卡时。
'tablist' - 用于表示选项卡列表时。
'timer' - 用于表示计时器时。
'toolbar' - 用于表示工具栏（动作按钮或组件的容器）时。

类型
string

`accessibilityState`

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

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

类型
object: `{disabled: bool, selected: bool, checked: bool or 'mixed', busy: bool, expanded: bool}`

`accessibilityActions`

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

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

类型
array

`aria-busy`

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

类型	默认值
boolean	false

`aria-checked`

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

类型	默认值
boolean, 'mixed'	false

`aria-disabled`

表示该元素可感知但已禁用，因此不可编辑或不可操作。

类型	默认值
boolean	false

`aria-expanded`

表示可展开元素当前是展开还是折叠状态。

类型	默认值
boolean	false

`aria-hidden`

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

例如，在一个包含同级视图 A 和 B 的窗口中，将视图 B 上的 aria-hidden 设为 true 会导致 VoiceOver 忽略 B 元素及其子元素。

类型	默认值
boolean	false

`aria-label`

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

类型
string

`aria-live`
Android

表示某个元素将被更新，并描述用户代理、辅助技术以及用户可以从实时区域预期到的更新类型。

off 辅助功能服务不应播报对此视图的更改。
polite 辅助功能服务应播报对此视图的更改。
assertive 辅助功能服务应中断当前语音，立即播报对此视图的更改。

类型	默认值
enum(`'assertive'`, `'off'`, `'polite'`)	`'off'`

`aria-modal`
iOS

一个布尔值，表示 VoiceOver 是否应忽略接收者同级视图内的元素。其优先级高于 accessibilityViewIsModal 属性。

类型	默认值
boolean	false

`aria-selected`

表示某个可选择元素当前是否被选中。

类型
boolean

`onAccessibilityAction`

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

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

类型
function

`accessibilityValue`

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

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

类型
object: `{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-index 始终具有优先级。

类型
Rect or number

`id`

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

类型
string

`onBlur`

在项目失去焦点时调用。

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

`onFocus`

在项目获得焦点时调用。

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

`onLayout`

在挂载和布局变化时调用。

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

`onLongPress`

如果在 onPressIn 之后经过的时间超过 370 毫秒，则调用。此时间可通过 delayLongPress 自定义。

类型
function

`onPress`

在触摸释放时调用，但如果被取消则不会调用（例如，被抢走 responder 锁的滚动操作）。第一个函数参数是 PressEvent 形式的事件。

类型
function

`onPressIn`

触摸可按元素后立即调用，甚至早于 onPress。这在发起网络请求时可能很有用。第一个函数参数是 PressEvent 形式的事件。

类型
function

`onPressOut`

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

类型
function

`pressRetentionOffset`

当滚动视图被禁用时，这定义了触摸可以从按钮移开的距离，超过该距离后按钮会失活。失活后，再把它移回去，你会看到按钮会再次激活！在滚动视图被禁用时，可以来回移动几次。确保传入一个常量以减少内存分配。

类型
Rect or number

`nativeID`

类型
string

`testID`

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

类型
string

`touchSoundDisabled`
Android

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

类型
Boolean

使用模式​

示例​

参考

属性​

accessibilityIgnoresInvertColors iOS​

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`
iOS

`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