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