跳至主要内容

Button

一个基本的按钮组件，应该可以在任何平台上很好地渲染。支持最少的自定义级别。

如果此按钮在您的应用中看起来不正确，您可以使用 Pressable 构建自己的按钮。获取灵感，请查看 Button 组件的源代码。

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

示例​

参考

属性​

必填
onPress​

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

类型
({nativeEvent: PressEvent})

必填
title​

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

类型
字符串

accessibilityLabel​

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

类型
字符串

accessibilityLanguage
iOS
​

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

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

类型
字符串

accessibilityActions​

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

请参阅 辅助功能指南 以获取更多信息。

类型必填
数组否

onAccessibilityAction​

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

请参阅 辅助功能指南 以获取更多信息。

类型必填
函数否

color​

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

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

disabled​

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

类型默认值
布尔值false

hasTVPreferredFocus
电视
​

电视首选焦点。

类型默认值
布尔值false

nextFocusDown
Android
电视
​

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

类型
数字

nextFocusForward
Android
电视
​

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

类型
数字

nextFocusLeft
Android
电视
​

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

类型
数字

nextFocusRight
Android
电视
​

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

类型
数字

nextFocusUp
Android
电视
​

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

类型
数字

testID​

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

类型
字符串

touchSoundDisabled
Android
​

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

类型默认值
布尔值false