【亲测免费】开源项目 SwitchButton 使用教程

2026-01-16 10:05:01作者：余洋婵Anita

1. 项目介绍

SwitchButton 是一个专为 Android 设计的美观、轻量级且易于定制的切换按钮控件。该库由 zcweng 创建，适用于 minSdkVersion >= 11 的 Android 平台。它提供了丰富的自定义样式功能，支持动画效果，并优化了尺寸计算和手势处理。SwitchButton 在 GitHub 上获得了超过 2.7k 星标，具有 MIT 许可证。

2. 项目快速启动

要在你的项目中集成 SwitchButton，首先需要在你的 build.gradle 文件添加依赖：

dependencies {
    implementation 'com.kyleduo.switchbutton:library:2.1.0'
}

同步完成后，可以在 XML 布局文件中像这样添加 SwitchButton：

<com.kyleduo.switchbutton.SwitchButton
    android:id="@+id/switch_button"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content" />

在 Java 或 Kotlin 代码中，你可以这样操控 SwitchButton：

// Kotlin
val switchButton = findViewById<SwitchButton>(R.id.switch_button)
switchButton.setChecked(true) // 设置开关状态
switchButton.toggle() // 切换开关状态
switchButton.setOnCheckedChangeListener { _, isChecked ->
    // 检查状态改变时的回调
}

// Java
SwitchButton switchButton = findViewById(R.id.switch_button);
switchButton.setChecked(true); // 设置开关状态
switchButton.toggle(); // 切换开关状态
switchButton.setOnCheckedChangeListener(new OnCheckedChangeListener() {
    @Override
    public void onCheckedChanged(SwitchButton buttonView, boolean isChecked) {
        // 检查状态改变时的回调
    }
});

3. 应用案例和最佳实践

自定义样式：通过设置属性如 kswThumbColor 和 kswTrackColor 可以改变滑块和轨道的颜色。
尺寸控制：使用确切的宽度和高度来设定 SwitchButton 大小，例如 android:layout_width="50dp" 和 android:layout_height="30dp"。
滚动事件处理：当在可滚动视图内使用 SwitchButton 时，它只会消耗水平方向的滚动事件，避免影响垂直滚动。