跳到主要内容
版本：0.83

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>;

示例​

参考

Props​

accessibilityIgnoresInvertColors
iOS
​

一个值，用于指示当启用颜色反转时，此视图是否应被反转。值为 true 时，即使启用了颜色反转，也会告诉视图不要被反转。

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

Type
Boolean

accessible​

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

Type
bool

accessibilityLabel​

覆盖用户与元素交互时屏幕阅读器读取的文本。默认情况下，该标签通过遍历所有子元素并收集所有 Text 节点（以空格分隔）来构造。

Type
string

accessibilityLanguage
iOS
​

一个值，用于指示用户与元素交互时屏幕阅读器应使用哪种语言。它应遵循 BCP 47 规范。

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

Type
string

accessibilityHint​

当从无障碍标签中无法清楚看出执行某个操作会发生什么时，无障碍提示有助于用户理解在无障碍元素上执行操作后会发生什么。

Type
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' - 用于表示工具栏（按钮或组件的容器）。
Type
string

accessibilityState​

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

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

Type
object: {disabled: bool, selected: bool, checked: bool or 'mixed', busy: bool, expanded: bool}

accessibilityActions​

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

有关更多信息，请参阅 可访问性指南。

Type
array

aria-busy​

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

TypeDefault
booleanfalse

aria-checked​

表示可勾选元素的状态。此字段可以是布尔值，也可以是表示混合复选框的 "mixed" 字符串。

TypeDefault
boolean, 'mixed'false

aria-disabled​

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

TypeDefault
booleanfalse

aria-expanded​

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

TypeDefault
booleanfalse

aria-hidden​

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

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

TypeDefault
booleanfalse

aria-label​

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

Type
string

aria-live
Android
​

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

  • off 辅助功能服务不应宣布对此视图的更改。
  • polite 辅助功能服务应宣布对此视图的更改。
  • assertive 辅助功能服务应中断当前语音，立即宣布对此视图的更改。
TypeDefault
enum('assertive', 'off', 'polite')'off'

aria-modal
iOS
​

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

TypeDefault
booleanfalse

aria-selected​

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

Type
boolean

onAccessibilityAction​

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

有关更多信息，请参阅 可访问性指南。

Type
function

accessibilityValue​

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

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

Type
object: {min: number, max: number, now: number, text: string}

aria-valuemax​

表示基于范围的组件（如滑块和进度条）的最大值。其优先级高于 accessibilityValue 属性中的 max 值。

Type
number

aria-valuemin​

表示基于范围的组件（如滑块和进度条）的最小值。其优先级高于 accessibilityValue 属性中的 min 值。

Type
number

aria-valuenow​

表示基于范围的组件（如滑块和进度条）的当前值。其优先级高于 accessibilityValue 属性中的 now 值。

Type
number

aria-valuetext​

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

Type
string

delayLongPress​

从 onPressIn 开始到调用 onLongPress 之间的持续时间（毫秒）。

Type
number

delayPressIn​

从触摸开始到调用 onPressIn 之间的持续时间（毫秒）。

Type
number

delayPressOut​

从触摸释放到调用 onPressOut 之间的持续时间（毫秒）。

Type
number

disabled​

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

Type
bool

hitSlop​

这定义了你的触摸可以从距离按钮多远的位置开始。它会在离开按钮时被添加到 pressRetentionOffset 中。

备注

触摸区域绝不会超出父视图边界，而且如果一次触摸命中两个重叠视图，兄弟视图的 Z-index 始终优先。

Type
Rect or number

id​

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

Type
string

onBlur​

在项目失去焦点时调用。

Type
({nativeEvent: TargetEvent}) => void

onFocus​

在项目获得焦点时调用。

Type
({nativeEvent: TargetEvent}) => void

onLayout​

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

Type
({nativeEvent: LayoutEvent}) => void

onLongPress​

当 onPressIn 之后的持续时间超过 370 毫秒时调用。这个时间可以通过 delayLongPress 自定义。

Type
function

onPress​

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

Type
function

onPressIn​

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

Type
function

onPressOut​

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

Type
function

pressRetentionOffset​

当滚动视图被禁用时，它定义了你的触摸在按钮外最多可以移动多远，才会使按钮失效。一旦失效，尝试把它移回去，你会看到按钮再次被激活！在滚动视图被禁用时，可前后移动几次。确保传入一个常量以减少内存分配。

Type
Rect or number

nativeID​

Type
string

testID​

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

Type
string

touchSoundDisabled
Android
​

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

Type
Boolean