跳到主要内容

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)。

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

disabled​

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

类型默认值
boolfalse

hasTVPreferredFocus
TV
​

TV 偏好焦点。

类型默认值
boolfalse

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，则触摸时不会播放系统声音。

类型默认值
booleanfalse