Switch
跨平台通用的“开关”组件。
注意这是一个“受控组件”(controlled component)。你必须使用onValueChange
回调来更新value
属性以响应用户的操作。如果不更新value
属性,组件只会按一开始给定的value
值来渲染且保持不变,看上去就像完全点不动。
示例
文档
Props
View Props
继承了所有的View Props.
disabled
如果为true
则禁用此组件的交互。
类型 | Default |
---|---|
bool | false |
ios_backgroundColor
iOS
在 iOS 上,自定义背景颜色。这种背景颜色可以在开关值为false
时或开关被禁用(且开关呈半透明状态)时看到。
类型 |
---|
color |
onChange
当值改变的时候调用此回调函数,参数为事件。如果你只想接收新值,请改用 onValueChange
。
类 型 |
---|
function |
onValueChange
当值改变的时候调用此回调函数,参数为新的值。如果你想接收一个完整事件,请使用 onChange
。
类型 |
---|
function |
thumbColor
开关上圆形按钮的背景颜色。在 iOS 上设置此颜色会丢失按钮的投影效果。
类型 |
---|
color |
trackColor
关闭状态时的边框颜色(iOS)或背景颜色(Android)。
iOS: 当开关值为 false
时,轨道会收缩到边框内。如果你想改变收缩后轨道露出的背景颜色,请使用 ios_backgroundColor
。
Type |
---|
object: {false: color, true: color} |
value
表示此开关是否打开。默认为 false(关闭状态)。
类型 |
---|
bool |