Switch
渲染一个布尔输入。
这是一个受控组件,需要一个 onValueChange 回调来更新 value prop,以便组件反映用户操作。如果 value prop 未更新,组件将继续渲染提供的 value prop,而不是任何用户操作的预期结果。
示例
参考
属性
视图属性
继承自 View 属性。
disabled
如果为 true,用户将无法切换开关。
| 类型 | 默认 |
|---|---|
| 布尔值 | false |
ios_backgroundColor iOS
在 iOS 上,自定义背景颜色。当开关值为 false 或开关被禁用(且开关为半透明)时,可以看到此背景颜色。
| 类型 |
|---|
| 颜色 |
onChange
当用户尝试更改开关值时调用。将更改事件作为参数接收。如果只想接收新值,请改用 onValueChange。
| 类型 |
|---|
| 函数 |
onValueChange
当用户尝试更改开关值时调用。将新值作为参数接收。如果想接收事件,请改用 onChange。
| 类型 |
|---|
| 函数 |
ref
一个 ref 设置器,在挂载时将被分配一个元素节点。
thumbColor
前景开关手柄的颜色。如果在 iOS 上设置此项,开关手柄将失去其阴影。
| 类型 |
|---|
| 颜色 |
trackColor
开关轨道(track)的自定义颜色。
iOS: 当开关值为 false 时,轨道会收缩到边框中。如果想更改收缩轨道暴露的背景颜色,请使用 ios_backgroundColor。
value
开关的值。如果为 true,则开关将打开。默认值为 false。
| 类型 |
|---|
| 布尔值 |