添加用户可以切换的开关

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

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

该组件包含两个部分：滑块和轨道。滑块是开关的可拖动部分，轨道是背景。用户可以向左或向右拖动滑块来更改开关的状态。他们还可以轻按开关来选中和清除它。

版本兼容性

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

依赖项

实现开关

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

结果

创建自定义滑块

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

结果

未选中时的外观与上一部分中的示例相同。不过，选中时，此实现会显示如下：

使用自定义颜色

使用 colors 参数更改开关的滑块和轨道的颜色，同时考虑开关是否已选中。

结果

要点

• 基本参数：

  • checked：开关的初始状态。
  • onCheckedChange：当开关的状态发生变化时调用的回调。
  • enabled：开关处于启用还是停用状态。
  • colors：用于开关的颜色。

• 高级参数

  • thumbContent：用于自定义滑块在选中时的外观。
  • colors：用于自定义轨道和滑块的颜色。

包含本指南的集合

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

有疑问或反馈吗？

前往我们的常见问题解答页面，了解有关快速指南的信息；或者联系我们并告知您的想法。

前往常见问题解答页面 提供反馈