跳到主要内容
版本:Next

Switch

渲染一个布尔输入。

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

示例


参考

属性

View Props

继承自 View Props


disabled

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

类型默认值
boolfalse

ios_backgroundColor
iOS

在 iOS 上,背景的自定义颜色。无论开关值为 false 还是开关被禁用(且开关是半透明的),都能看到此背景色。

类型
color

onChange

当用户尝试更改开关值时触发。将更改事件作为参数接收。如果你只想接收新值,请改用 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