Button
一个基本的按钮组件,它应该在任何平台上都能良好渲染。支持最低限度的自定义。
如果这个按钮不适合你的应用,你可以使用 Pressable 构建自己的按钮。如需灵感,请查看 Button 组件的源代码。
tsx
<Button
onPress={onPressLearnMore}
title="Learn More"
color="#841584"
accessibilityLabel="Learn more about this purple button"
/>
示例
参考
属性
必需onPress
当用户点击按钮时要调用的处理程序。
类型 |
---|
({nativeEvent: PressEvent}) |
必需title
要在按钮内部显示的文本。在 Android 上,给定的标题将被转换为大写形式。
类型 |
---|
string |
accessibilityLabel
用于盲人无障碍功能的显示文本。
类型 |
---|
string |
accessibilityLanguage
iOS
一个值,指示当用户与元素交互时屏幕阅读器应使用的语言。它应遵循 BCP 47 规范。
有关更多信息,请参阅 iOS accessibilityLanguage
文档。
类型 |
---|
string |
accessibilityActions
辅助功能操作允许辅助技术以编程方式调用组件的操作。accessibilityActions
属性应包含一个操作对象列表。每个操作对象应包含字段名和标签。
有关更多信息,请参阅辅助功能指南。
类型 | 必需 |
---|---|
array | 否 |
onAccessibilityAction
当用户执行辅助功能操作时调用。此函数唯一的参数是一个包含要执行的操作名称的事件。
有关更多信息,请参阅辅助功能指南。
类型 | 必需 |
---|---|
function | 否 |
color
文本颜色 (iOS) 或按钮背景颜色 (Android)。
类型 | 默认值 |
---|---|
颜色 | '#2196F3' Android '#007AFF' iOS |
disabled
如果为 true
,则禁用此组件的所有交互。
类型 | 默认值 |
---|---|
bool | false |
hasTVPreferredFocus
电视
电视优先焦点。
类型 | 默认值 |
---|---|
bool | false |
nextFocusDown
Android电视
指定用户向下导航时下一个接收焦点的视图。请参阅 Android 文档。
类型 |
---|
number |
nextFocusForward
Android电视
指定用户向前导航时下一个接收焦点的视图。请参阅 Android 文档。
类型 |
---|
number |
nextFocusLeft
Android电视
指定用户向左导航时下一个接收焦点的视图。请参阅 Android 文档。
类型 |
---|
number |
nextFocusRight
Android电视
指定用户向右导航时下一个接收焦点的视图。请参阅 Android 文档。
类型 |
---|
number |
nextFocusUp
Android电视
指定用户向上导航时下一个接收焦点的视图。请参阅 Android 文档。
类型 |
---|
number |
testID
用于在端到端测试中定位此视图。
类型 |
---|
string |
touchSoundDisabled
Android
如果为 true
,则在触摸时不播放系统声音。
类型 | 默认值 |
---|---|
boolean | false |