跳到主要内容
版本: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