跳到主要内容

Switch

渲染一个布尔输入。

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

示例​

参考

属性​

View 属性​

继承自 View 属性。

disabled​

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

类型默认值
boolfalse

ios_backgroundColor
iOS
​

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

类型
颜色

onChange​

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

类型
函数

onValueChange​

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

类型
函数

thumbColor​

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

类型
颜色

trackColor​

开关轨道的自定义颜色。

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

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

value​

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

类型
bool