版本:Next
Switch
渲染一个布尔输入。
这是一个受控组件,需要提供 onValueChange 回调来更新 value 属性,这样组件才能反映用户操作。如果 value 属性未更新,组件将继续渲染所提供的 value 属性,而不是任何用户操作所期望的结果。
示例
参考
属性
View Props
继承自 View Props。
disabled
如果为 true,用户将无法切换开关。
| 类型 | 默认值 |
|---|---|
| bool | false |
ios_backgroundColor iOS
在 iOS 上,背景的自定义颜色。无论开关值为 false 还是开关被禁用(且开关是半透明的),都能看到此背景色。
| 类型 |
|---|
| color |
onChange
当用户尝试更改开关值时触发。将更改事件作为参数接收。如果你只想接收新值,请改用 onValueChange。
| 类型 |
|---|
| function |
onValueChange
当用户尝试更改开关值时触发。将新值作为参数接收。如果你想接收事件,请改用 onChange。
| 类型 |
|---|
| function |
ref
一个 ref setter,在挂载时会被分配到一个 element node。
thumbColor
前景开关滑块的颜色。如果在 iOS 上设置了此属性,开关滑块将失去其投影。
| 类型 |
|---|
| color |
trackColor
开关轨道的自定义颜色。
iOS:当开关值为 false 时,轨道会缩入边框中。如果你想更改缩小后的轨道所露出的背景颜色,请使用 ios_backgroundColor。
value
开关的值。如果为 true,开关将处于开启状态。默认值为 false。
| 类型 |
|---|
| bool |