跳到主要内容

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

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

'#007AFF'
iOS

disabled

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

类型默认值
boolfalse

hasTVPreferredFocus
电视

电视优先焦点。

类型默认值
boolfalse

nextFocusDown
Android
电视

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

类型
number

nextFocusForward
Android
电视

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

类型
number

nextFocusLeft
Android
电视

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

类型
number

nextFocusRight
Android
电视

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

类型
number

nextFocusUp
Android
电视

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

类型
number

testID

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

类型
string

touchSoundDisabled
Android

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

类型默认值
booleanfalse