切换

通过 Switch 组件,用户可以在两种状态之间切换:选中和未选中。在您的应用中,您可以使用开关让用户执行以下操作之一:

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

该组件包含两个部分:滑块和滑道。滑块是开关的可拖动部分,轨道是背景。用户可以向左或向右拖动滑块以更改开关的状态。用户还可以点按开关,查看并清除相应数据。

浅色模式和深色模式下的 Switch 组件示例。
图 1. switch 组件。

基本实现方法

如需了解完整的 API 定义,请参阅 Switch 参考文档。以下是您可能需要使用的一些关键参数:

  • checked:开关的初始状态。
  • onCheckedChange:开关状态更改时调用的回调。
  • enabled:开关是处于启用状态还是处于停用状态。
  • colors:开关使用的颜色。

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

@Composable
fun SwitchMinimalExample() {
    var checked by remember { mutableStateOf(true) }

    Switch(
        checked = checked,
        onCheckedChange = {
            checked = it
        }
    )
}

如果未选中,此实现如下所示:

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

选中后,外观如下:

一个已选中的基本开关。
图 3. 选中的开关。

高级实现

在实现更高级的开关时,可能需要使用的主要参数包括:

  • thumbContent:使用此选项可自定义拇指被选中时的外观。
  • colors:使用此选项可自定义轨迹和滑块的颜色。

自定义缩略图

您可以为 thumbContent 参数传递任何可组合项来创建自定义缩略图。以下示例展示了使用自定义图标作为其拇指的开关:

@Composable
fun SwitchWithIconExample() {
    var checked by remember { mutableStateOf(true) }

    Switch(
        checked = checked,
        onCheckedChange = {
            checked = it
        },
        thumbContent = if (checked) {
            {
                Icon(
                    imageVector = Icons.Filled.Check,
                    contentDescription = null,
                    modifier = Modifier.size(SwitchDefaults.IconSize),
                )
            }
        } else {
            null
        }
    )
}

在此实现中,未检查的外观与上一部分中的示例相同。不过,勾选后,此实现如下所示:

处于选中状态时,可使用 thumbContent 参数显示自定义图标的开关。
图 4. 带有自定义勾选图标的开关。

自定义颜色

以下示例演示了如何使用颜色参数在考虑开关是否处于选中状态的情况下,更改开关滑块和滑道的颜色。

@Composable
fun SwitchWithCustomColors() {
    var checked by remember { mutableStateOf(true) }

    Switch(
        checked = checked,
        onCheckedChange = {
            checked = it
        },
        colors = SwitchDefaults.colors(
            checkedThumbColor = MaterialTheme.colorScheme.primary,
            checkedTrackColor = MaterialTheme.colorScheme.primaryContainer,
            uncheckedThumbColor = MaterialTheme.colorScheme.secondary,
            uncheckedTrackColor = MaterialTheme.colorScheme.secondaryContainer,
        )
    )
}

此实现如下所示:

一个开关,它使用颜色参数来显示开关,且滑块和图钉都有自定义颜色。
图 5. 带有自定义颜色的开关。

其他资源