跳到主要内容
版本:0.85

开关

渲染一个布尔输入。

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

示例​


参考

属性​

View Props​

继承自 View Props。


disabled​

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

TypeDefault
boolfalse

ios_backgroundColor
iOS
​

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

Type
color

onChange​

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

Type
function

onValueChange​

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

Type
function

ref​

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


thumbColor​

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

Type
color

trackColor​

开关轨道的自定义颜色。

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

Type
object: {false: color, true: color}

value​

开关的值。如果为 true,开关将打开。默认值为 false。

Type
bool