借助 Switch
组件,用户可以在两种状态(已选中和未选中)之间切换。使用开关可让用户执行以下任一操作:
- 开启或关闭某项设置。
- 启用或停用功能。
- 选择一个选项。
该组件由两个部分组成:滑块和滑道。滑块是开关的可拖动部分,滑道是背景。用户可以将滑块向左或向右拖动,以更改开关的状态。用户还可以点按开关进行检查和清除。
版本兼容性
此实现要求将项目 minSDK 设置为 API 级别 21 或更高级别。
依赖项
实现开关
以下示例是 Switch
可组合项的最小实现:
结果
![未选中的基本开关。](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-deactivated.png?hl=zh-cn)
![处于选中状态的基本开关。](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch.png?hl=zh-cn)
创建自定义滑块
您可以为 thumbContent
参数传递任何可组合项,以创建自定义滑块。以下是使用自定义图标作为滑块的开关示例:
结果
未选中时的显示效果与上一部分中的示例相同。不过,经过检查,此实现会显示如下所示:
![一个开关,使用 thumbContent 参数在选中时显示自定义图标。](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-icon.png?hl=zh-cn)
使用自定义颜色
使用 colors
参数更改开关滑块和滑道的颜色,同时考虑开关是否处于勾选状态。
结果
![使用 colors 参数显示的开关,其中滑块和标记均采用自定义颜色。](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-colors.png?hl=zh-cn)
要点
基本参数:
checked
:开关的初始状态。onCheckedChange
:在开关状态发生变化时调用的回调。enabled
:开关是启用还是停用。colors
:用于开关的颜色。
高级参数
thumbContent
:使用此属性可自定义勾选状态下的滑块的外观。colors
:用于自定义滑道和滑块的颜色。
包含本指南的集合
本指南属于以下精选快速入门集合,这些集合涵盖了更广泛的 Android 开发目标:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=zh-cn)
显示互动组件
了解如何使用可组合函数根据 Material Design 设计系统轻松创建美观的界面组件。
有问题或反馈
请访问我们的常见问题解答页面,了解简短指南,或与我们联系,告诉我们您的想法。