按钮

一个基本的按钮组件，在任何平台上都能很好地渲染。支持最低限度的自定义。

如果此按钮不适合您的应用程序，您可以使用 Pressable 构建自己的按钮。如需灵感，请查看 Button 组件的源代码。

tsx

<Button
  onPress={onPressLearnMore}
  title="Learn More"
  color="#841584"
  accessibilityLabel="Learn more about this purple button"
/>

示例

---

参考

属性

必需

onPress

当用户点击按钮时调用的处理程序。

类型
({nativeEvent: PressEvent})

---

必需

title

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

类型
字符串

---

accessibilityLabel

用于盲人辅助功能的显示文本。

类型
字符串

---

无障碍语言

iOS

指示屏幕阅读器在用户与元素交互时应使用的语言值。它应遵循 BCP 47 规范。

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

类型
字符串

---

accessibilityActions

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

有关更多信息，请参阅辅助功能指南。

类型	必需
数组	否

---

onAccessibilityAction

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

有关更多信息，请参阅辅助功能指南。

类型	必需
函数	否

---

color

文本颜色 (iOS)，或按钮背景色 (Android)。

类型	默认
颜色	'#2196F3' 安卓 '#007AFF' iOS

---

disabled

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

类型	默认
布尔值	假

---

hasTVPreferredFocus

电视

TV 优先焦点。

类型	默认
布尔值	假

---

nextFocusDown

安卓

电视

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

类型
数字

---

nextFocusForward

安卓

电视

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

类型
数字

---

nextFocusLeft

安卓

电视

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

类型
数字

---

nextFocusRight

安卓

电视

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

类型
数字

---

nextFocusUp

安卓

电视

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

类型
数字

---

testID

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

类型
字符串

---

touchSoundDisabled

安卓

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

类型	默认
布尔值	假