Wechseln

Mit der Komponente Switch können Nutzer zwischen zwei Zuständen wechseln: angeklickt und nicht angeklickt. In Ihrer App können Sie einen Schalter verwenden, um Nutzern Folgendes zu ermöglichen:

  • Aktivieren oder deaktivieren Sie eine Einstellung.
  • Aktivieren oder deaktivieren Sie eine Funktion.
  • Wählen Sie eine Option aus.

Die Komponente besteht aus zwei Teilen: dem Schieberegler und dem Track. Der Schieberegler ist der bewegliche Teil des Schalters und der Track ist der Hintergrund. Der Nutzer kann den Schieberegler nach links oder rechts ziehen, um den Status des Schalters zu ändern. Sie können auch auf den Schalter tippen, um die Option zu aktivieren oder zu deaktivieren.

Beispiele für die Komponente „Schalter“ im hellen und dunklen Modus
Abbildung 1: Die Schalterkomponente.

Einfache Implementierung

Eine vollständige API-Definition finden Sie in der Switch-Referenz. Im Folgenden sind einige der wichtigsten Parameter aufgeführt, die Sie möglicherweise verwenden müssen:

  • checked: Der anfängliche Status des Schalters.
  • onCheckedChange: Ein Rückruf, der aufgerufen wird, wenn sich der Status des Schalters ändert.
  • enabled: Gibt an, ob der Schalter aktiviert oder deaktiviert ist.
  • colors: Die für den Schalter verwendeten Farben.

Das folgende Beispiel ist eine minimale Implementierung des Switch-Kompositionstyps.

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

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

Wenn diese Option deaktiviert ist, sieht die Implementierung so aus:

Ein einfacher Schalter, der nicht angeklickt ist.
Abbildung 2: Ein Kästchen ohne Häkchen.

So sieht es aus, wenn die Option aktiviert ist:

Ein einfacher Schalter, der aktiviert ist.
Abbildung 3 Ein angeklickter Schalter.

Erweiterte Implementierung

Die wichtigsten Parameter, die Sie bei der Implementierung eines erweiterten Schalters verwenden können, sind:

  • thumbContent: Hiermit können Sie das Aussehen des Thumbnails anpassen, wenn es ausgewählt ist.
  • colors: Hiermit kannst du die Farbe des Titels und des Thumbnails anpassen.

Benutzerdefiniertes Thumbnail

Du kannst einen beliebigen Composeable-Parameter für den Parameter thumbContent übergeben, um einen benutzerdefinierten Thumbnail zu erstellen. Im folgenden Beispiel wird ein Schalter mit einem benutzerdefinierten Symbol für den Schieberegler verwendet:

@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
        }
    )
}
Switch.kt

In dieser Implementierung entspricht das Erscheinungsbild der Option, wenn sie deaktiviert ist, dem Beispiel im vorherigen Abschnitt. Wenn diese Option aktiviert ist, sieht die Implementierung jedoch so aus:

Ein Schalter, der mit dem Parameter „thumbContent“ ein benutzerdefiniertes Symbol anzeigt, wenn er aktiviert ist.
Abbildung 4: Ein Schalter mit einem benutzerdefinierten Häkchensymbol.

Benutzerdefinierte Farben

Im folgenden Beispiel wird gezeigt, wie Sie mit dem Parameter „colors“ die Farbe des Schiebereglers und des Schiebewegs ändern können, wobei berücksichtigt wird, ob der Schalter aktiviert ist.

@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,
        )
    )
}
Switch.kt

Diese Implementierung sieht so aus:

Ein Schalter, der mit dem Parameter „colors“ einen Schalter mit benutzerdefinierten Farben für den Schieberegler und den Stift anzeigt.
Abbildung 5. Ein Schalter mit benutzerdefinierten Farben.

Weitere Informationen