此页面由 Cloud Translation API 翻译。

添加用户可以切换的开关

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

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

版本兼容性

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

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

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

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

图 3. 带有自定义已选中图标的开关。

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

基本参数：
- checked：开关的初始状态。
- onCheckedChange：在开关状态发生变化时调用的回调。
- enabled：开关是启用还是停用。
- colors：用于开关的颜色。
高级参数
- thumbContent：使用此属性可自定义勾选状态下的滑块的外观。
- colors：用于自定义滑道和滑块的颜色。