跳到主要内容

Switch

渲染一个布尔输入。

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

示例


参考

属性

View 属性

继承自 View 属性


disabled

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

类型默认
布尔值false

ios_backgroundColor
iOS

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

类型
颜色

onChange

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

类型
函数

onValueChange

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

类型
函数

thumbColor

前景开关手柄的颜色。如果在 iOS 上设置此项,开关手柄将失去其阴影。

类型
颜色

trackColor

开关轨道的自定义颜色。

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

类型
object: {false: 颜色, true: 颜色}

value

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

类型
布尔值