Switch(开关)

风格类iOS的开关组件，支持属性定制自定义开关样式

组件使用示例

属性

支持所有基础属性，此外还支持：

isOn

设置开关

参数	描述	类型
on	开关是否打开	Boolean

onColor

设置开关打开时的高亮色（背景色）

参数	描述	类型
color	开关打开时的高亮色	Color

unOnColor

设置开关关闭时的背景色

参数	描述	类型
color	开关关闭时的背景色	Color

thumbColor

设置圆型滑块颜色（关闭和开启同一个颜色）

参数	描述	类型
color	圆型滑块颜色	Color

thumbMargin

圆块与开关的贴边边距，默认为2f

参数	描述	类型
margin	圆块与开关的贴边边距	Float

enableGlassEffect

系统要求

iOS 26.0+ 支持。在低版本系统上会自动使用标准开关外观。

启用iOS 26+液态玻璃效果。

参数	描述	类型	默认值
enabled	是否启用液态玻璃效果	Boolean	false

示例：

Switch {
    attr {
        enableGlassEffect(true) // 启用液态玻璃效果
        isOn(true)
    }
}

限制说明

启用液态玻璃效果后，以下自定义属性将不再生效：

• thumbMargin - 圆块与开关的贴边边距
• 其他视觉自定义效果可能被系统效果覆盖

兼容性处理

Switch {
    attr {
        // 内部自动降级处理，仅iOS 26+会自动启用液态玻璃
        enableGlassEffect(true)
        isOn(true)
        onColor(Color(0xFF34C759))
        unOnColor(Color(0xFF8E8E93))
        thumbColor(Color.WHITE)
    }
}

事件

支持所有基础事件，此外还支持：

switchOnChanged

开关变化时的回调，回调会传入开关状态参数：

参数	描述	类型
on	开关状态（是否打开）	Boolean

@Page("demo_page")
internal class TestPage : BasePager() {
    override fun body(): ViewBuilder {
        return {
            attr {
                allCenter()
            }
            Switch {
                attr {
                    isOn(true)
                }
                event {
                    switchOnChanged {
                        KLog.i("Switch", "switchOnChanged $it")
                    }
                }
            }
        }
    }
}