开关

非官方测试版翻译

本页面由 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。

Type
object: {false: color, true: color}

---

value

开关的布尔值。设为 true 时开关将处于开启状态，默认值为 false。

Type
bool