按钮

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

一个基础按钮组件，可在所有平台上良好渲染。支持最小程度的自定义配置。

如果此按钮不符合你的应用需求，可以使用 Pressable 构建自定义按钮。参考 Button 组件源代码获取灵感。

tsx

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

示例

---

参考

属性

Required

onPress

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

Type
({nativeEvent: PressEvent})

---

Required

title

按钮内显示的文本。在 Android 平台上，标题文本会自动转换为大写形式。

Type
string

---

accessibilityLabel

为视障辅助功能显示的描述文本。

Type
string

---

accessibilityLanguage

iOS

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

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

Type
string

---

accessibilityActions

辅助操作允许辅助技术以编程方式触发组件的操作。accessibilityActions 属性应包含操作对象列表，每个对象需包含 name 和 label 字段。

详见辅助功能指南。

Type	Required
array	No

---

onAccessibilityAction

当用户执行辅助操作时触发，该函数接收的唯一参数是包含要执行操作名称的事件对象。

详见辅助功能指南。

Type	Required
function	No

---

color

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

Type	Default
color	'#2196F3' Android '#007AFF' iOS

---

disabled

设为 true 时禁用该组件的所有交互。

Type	Default
bool	false

---

hasTVPreferredFocus

TV

电视设备首选焦点。

Type	Default
bool	false

---

nextFocusDown

Android

TV

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

Type
number

---

nextFocusForward

Android

TV

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

Type
number

---

nextFocusLeft

Android

TV

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

Type
number

---

nextFocusRight

Android

TV

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

Type
number

---

nextFocusUp

Android

TV

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

Type
number

---

testID

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

Type
string

---

touchSoundDisabled

Android

设为 true 时触摸不播放系统提示音。

Type	Default
boolean	false