Schieberegler

Mit der Slider-Composable können Nutzer aus einer Reihe von Werten auswählen. Mit einem Schieberegler können Sie dem Nutzer folgende Möglichkeiten bieten:

  • Einstellungen anpassen, die einen Wertebereich verwenden, z. B. Lautstärke und Helligkeit.
  • Daten in einem Diagramm filtern, z. B. beim Festlegen einer Preisspanne.
  • Nutzereingaben, z. B. das Festlegen einer Bewertung in einer Rezension.

Der Schieberegler enthält einen Pfad, einen Ziehpunkt, ein Wertlabel und Markierungen:

  • Track: Der Track ist der horizontale Balken, der den Wertebereich darstellt, den der Schieberegler annehmen kann.
  • Ziehpunkt: Der Ziehpunkt ist ein verschiebbares Steuerelement auf dem Schieberegler, mit dem der Nutzer einen bestimmten Wert innerhalb des vom Track definierten Bereichs auswählen kann.
  • Teilstriche: Teilstriche sind optionale visuelle Markierungen oder Indikatoren, die entlang des Schiebereglers angezeigt werden.
Ein Schieberegler mit Ziehpunkt, Pfad und Markierungen.
Abbildung 1: Eine Implementierung eines Schiebereglers.

Einfache Implementierung

Eine vollständige API-Definition finden Sie in der Slider-Referenz. Einige der wichtigsten Parameter für die zusammensetzbare Funktion Slider sind:

  • value: Der aktuelle Wert des Schiebereglers.
  • onValueChange: Ein Lambda, das jedes Mal aufgerufen wird, wenn sich der Wert ändert.
  • enabled: Ein boolescher Wert, der angibt, ob der Nutzer mit dem Schieberegler interagieren kann.

Das folgende Beispiel zeigt einen einfachen Schieberegler. So kann der Nutzer einen Wert zwischen 0.0 und 1.0 auswählen. Da der Nutzer einen beliebigen Wert in diesem Bereich auswählen kann, ist der Schieberegler kontinuierlich.

@Preview
@Composable
fun SliderMinimalExample() {
    var sliderPosition by remember { mutableFloatStateOf(0f) }
    Column {
        Slider(
            value = sliderPosition,
            onValueChange = { sliderPosition = it }
        )
        Text(text = sliderPosition.toString())
    }
}
Slider.kt

Diese Implementierung sieht so aus:

Eine Schieberegler-Komponente mit einem Wert, der etwa drei Viertel des Schiebereglers entfernt vom linken Ende ausgewählt wurde.
Abbildung 2. Eine einfache Implementierung eines Schiebereglers.

Erweiterte Implementierung

Bei der Implementierung eines komplexeren Sliders können Sie zusätzlich die folgenden Parameter verwenden.

  • colors: Eine Instanz von SliderColors, mit der Sie die Farben des Schiebereglers steuern können.
  • valueRange: Der Wertebereich, den der Schieberegler annehmen kann.
  • steps: Die Anzahl der Kerben auf dem Schieberegler, an denen der Ziehpunkt einrastet.

Im folgenden Snippet wird ein Schieberegler mit drei Schritten und einem Bereich von 0.0 bis 50.0 implementiert. Da der Schieberegler an jeder Stufe einrastet, ist er diskret.

@Preview
@Composable
fun SliderAdvancedExample() {
    var sliderPosition by remember { mutableFloatStateOf(0f) }
    Column {
        Slider(
            value = sliderPosition,
            onValueChange = { sliderPosition = it },
            colors = SliderDefaults.colors(
                thumbColor = MaterialTheme.colorScheme.secondary,
                activeTrackColor = MaterialTheme.colorScheme.secondary,
                inactiveTrackColor = MaterialTheme.colorScheme.secondaryContainer,
            ),
            steps = 3,
            valueRange = 0f..50f
        )
        Text(text = sliderPosition.toString())
    }
}
Slider.kt

Die Implementierung sieht so aus:

Ein diskreter Schieberegler mit einem Bereich von 0 bis 50 und fünf Markierungen in gleichen Abständen. Der Daumen befindet sich in der Nähe der zweiten Markierung, was einem Wert von 16 entspricht.
Abbildung 3. Ein Schieberegler mit Schritten und einem festgelegten Wertebereich.

Bereichsschieberegler

Sie können auch die spezielle zusammensetzbare Funktion RangeSlider verwenden. So kann der Nutzer zwei Werte auswählen. Das kann in Fällen nützlich sein, in denen der Nutzer einen Mindest- und Höchstpreis auswählen möchte.

Das folgende Beispiel zeigt einen relativ einfachen Schieberegler für einen kontinuierlichen Bereich.

@Preview
@Composable
fun RangeSliderExample() {
    var sliderPosition by remember { mutableStateOf(0f..100f) }
    Column {
        RangeSlider(
            value = sliderPosition,
            steps = 5,
            onValueChange = { range -> sliderPosition = range },
            valueRange = 0f..100f,
            onValueChangeFinished = {
                // launch some business logic update with the state you hold
                // viewModel.updateSelectedSliderValue(sliderPosition)
            },
        )
        Text(text = sliderPosition.toString())
    }
}
Slider.kt

Eine Bereichsschieberegler-Komponente mit zwei ausgewählten Werten. Ein Label zeigt die Ober- und Untergrenze der Auswahl an.
Abbildung 4: Eine Implementierung eines Bereichsschiebereglers.

Zusätzliche Ressourcen