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
iOS
一个值,表示当颜色反转开启时,此视图是否应该反转。值为 true
将告诉视图即使颜色反转开启也不要反转。
更多信息请参见无障碍性指南。
类型 |
---|
Boolean |
accessible
当 true
时,表示视图是一个无障碍性元素。默认情况下,所有可触摸元素都是可访问的。
类型 |
---|
布尔值 |
accessibilityLabel
覆盖屏幕阅读器在用户与元素交互时读取的文本。默认情况下,标签是通过遍历所有子元素并累积所有用空格分隔的 Text
节点来构建的。
类型 |
---|
字符串 |
无障碍语言
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: bool, selected: bool, checked: bool 或 'mixed', busy: bool, expanded: bool} |
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: number, max: number, now: number, text: string} |
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 轴顺序始终优先。
类型 |
---|
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,则触摸时不播放系统声音。
类型 |
---|
Boolean |