跳到主要内容
版本:0.82

开关

渲染一个布尔输入。

这是一个受控组件,需要一个 onValueChange 回调来更新 value 属性,组件才能反映用户操作。如果 value 属性未更新,组件将继续渲染所提供的 value 属性,而不是任何用户操作的预期结果。

示例


参考

属性

View Props

继承自 View Props


disabled

如果为 true,用户将无法切换开关。

类型默认值
boolfalse

ios_backgroundColor
iOS

在 iOS 上,背景的自定义颜色。当开关值为 false 时,或者当开关被禁用(且开关是半透明的)时,都可以看到此背景色。

类型
color

onChange

当用户尝试更改开关的值时触发。接收 change 事件作为参数。如果你只想接收新值,请改用 onValueChange

类型
function

onValueChange

当用户尝试更改开关的值时触发。接收新值作为参数。如果你想改为接收事件,请使用 onChange

类型
function

ref

一个 ref setter,在挂载时会被分配一个 element node


thumbColor

前景开关滑块的颜色。如果在 iOS 上设置此项,开关滑块将失去阴影效果。

类型
color

trackColor

开关轨道的自定义颜色。

iOS: 当开关值为 false 时,轨道会收缩到边框内。如果你想更改收缩后的轨道露出的背景颜色,请使用 ios_backgroundColor

类型
object: {false: color, true: color}

value

开关的值。如果为 true,开关将处于开启状态。默认值为 false。

类型
bool