Switch (开关)
渲染一个布尔输入。
这是一个受控组件,需要一个 onValueChange
回调,用于更新 value
属性,以便组件反映用户操作。如果 value
属性未更新,组件将继续渲染提供的 value
属性,而不是任何用户操作的预期结果。
示例
参考
Props (属性)
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 (布尔值) |