添加用户可以切换的开关

借助 Switch 组件,用户可以在两种状态(已选中和未选中)之间切换。使用开关可让用户执行以下任一操作:

  • 开启或关闭某项设置。
  • 启用或停用功能。
  • 选择一个选项。

该组件由两个部分组成:滑块和滑道。滑块是开关的可拖动部分,滑道是背景。用户可以将滑块向左或向右拖动,以更改开关的状态。用户还可以点按开关进行检查和清除。

版本兼容性

此实现要求将项目 minSDK 设置为 API 级别 21 或更高级别。

依赖项

实现开关

以下示例是 Switch 可组合项的最小实现:

结果

未选中的基本开关。
图 1. 未选中开关。
处于选中状态的基本开关。
图 2. 已选中状态的开关。

创建自定义滑块

您可以为 thumbContent 参数传递任何可组合项,以创建自定义滑块。以下是使用自定义图标作为滑块的开关示例:

结果

未选中时的显示效果与上一部分中的示例相同。不过,经过检查,此实现会显示如下所示:

一个开关,使用 thumbContent 参数在选中时显示自定义图标。
图 3. 带有自定义已选中图标的开关。

使用自定义颜色

使用 colors 参数更改开关滑块和滑道的颜色,同时考虑开关是否处于勾选状态。

结果

使用 colors 参数显示的开关,其中滑块和标记均采用自定义颜色。
图 4. 采用自定义颜色的开关。

要点

  • 基本参数:

    • checked:开关的初始状态。
    • onCheckedChange:在开关状态发生变化时调用的回调。
    • enabled:开关是启用还是停用。
    • colors:用于开关的颜色。
  • 高级参数

    • thumbContent:使用此属性可自定义勾选状态下的滑块的外观。
    • colors:用于自定义滑道和滑块的颜色。

包含本指南的集合

本指南属于以下精选快速入门集合,这些集合涵盖了更广泛的 Android 开发目标:

了解如何使用可组合函数根据 Material Design 设计系统轻松创建美观的界面组件。

有问题或反馈

请访问我们的常见问题解答页面,了解简短指南,或与我们联系,告诉我们您的想法。