跳到主要内容

Switch (开关)

渲染一个布尔输入。

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

示例


参考

Props (属性)

View Props (View 属性)

继承 View Props (View 属性)


disabled

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

类型默认值
bool (布尔值)false (假)

ios_backgroundColor
iOS

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

类型
颜色

onChange

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

类型
function (函数)

onValueChange

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

类型
function (函数)

thumbColor

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

类型
颜色

trackColor

开关轨道的自定义颜色。

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

类型
object (对象): {false: color (颜色), true: color (颜色)}

value

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

类型
bool (布尔值)