开关
非官方测试版翻译
本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →
渲染一个布尔值输入控件。
这是一个受控组件，必须提供 onValueChange 回调函数来更新 value 属性值，组件才能响应用户操作。若未更新 value 属性，组件将始终显示初始传入的 value 值，而不会反映用户操作结果。
示例
参考
属性
View 属性
继承 View 属性。
disabled
设为 true 时用户将无法切换开关状态。
| Type | Default |
|---|---|
| bool | false |
ios_backgroundColor iOS
在 iOS 上设置自定义背景色。当开关值为 false 或开关被禁用时（此时开关呈半透明状态），可以看到此背景色。
| Type |
|---|
| color |
onChange
用户点击分段时触发的回调函数，事件对象将作为参数传递
当用户尝试更改开关值时触发。接收变更事件作为参数。若只需获取新值，请改用 onValueChange。
| Type |
|---|
| function |
onValueChange
用户点击分段时触发的回调函数，分段值将作为参数传递
当用户尝试更改开关值时触发。接收新值作为参数。若需要获取事件对象，请改用 onChange。
| Type |
|---|
| function |
ref
一个在组件挂载时会被赋予元素节点的 ref 设置器。
thumbColor
开关滑块的背景色。在 iOS 上设置此属性会使滑块失去投影效果。
| Type |
|---|
| color |
trackColor
自定义开关轨道的颜色。
iOS：当开关值为 false 时，轨道会收缩至边框内。如需修改收缩轨道暴露的背景色，请使用 ios_backgroundColor。
value
开关的布尔值。设为 true 时开关将处于开启状态，默认值为 false。
| Type |
|---|
| bool |