跳到主要内容

Switch

渲染布尔输入。

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

示例


参考

Props

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