按钮

一个基础按钮组件，应在任何平台上都能很好地呈现。支持最基本程度的自定义。

如果这个按钮在你的应用中看起来不合适，你可以使用 Pressable 自己构建按钮。想获取灵感，请查看 Button 组件的源代码。

React TSX

<Button
  onPress={onPressLearnMore}
  title="了解更多"
  color="#841584"
  accessibilityLabel="了解更多关于这个紫色按钮的信息"
/>

示例

---

参考

属性

必需

onPress

用户点击按钮时要调用的处理函数。

类型
({nativeEvent: PressEvent})

---

必需

title

要显示在按钮内的文本。在 Android 上，给定的标题会转换为大写形式。

类型
string

---

accessibilityLabel

为无障碍辅助功能显示的文本。

类型
string

---

accessibilityLanguage

iOS

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

更多信息请参见 iOS accessibilityLanguage 文档。

类型
string

---

accessibilityActions

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

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

类型	必需
array	No

---

onAccessibilityAction

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

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

类型	必需
function	No

---

color

文本颜色（iOS），或按钮背景颜色（Android）。

类型	默认值
color	'#2196F3' Android '#007AFF' iOS

---

disabled

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

类型	默认值
bool	false

---

hasTVPreferredFocus

TV

电视优先聚焦。

类型	默认值
bool	false

---

nextFocusDown

Android

TV

指定用户向下导航时接收焦点的下一个视图。参见 Android 文档。

类型
number

---

nextFocusForward

Android

TV

指定用户向前导航时接收焦点的下一个视图。参见 Android 文档。

类型
number

---

nextFocusLeft

Android

TV

指定用户向左导航时接收焦点的下一个视图。参见 Android 文档。

类型
number

---

nextFocusRight

Android

TV

指定用户向右导航时接收焦点的下一个视图。参见 Android 文档。

类型
number

---

nextFocusUp

Android

TV

指定用户向上导航时接收焦点的下一个视图。参见 Android 文档。

类型
number

---

testID

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

类型
string

---

touchSoundDisabled

Android

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

类型	默认值
boolean	false