Dispositivo di scorrimento

Il componente componibile Slider consente agli utenti di effettuare selezioni da un intervallo di valori. Puoi utilizzare un cursore per consentire all'utente di:

  • Regola le impostazioni che utilizzano un intervallo di valori, come volume e luminosità.
  • Filtrare i dati in un grafico, ad esempio quando imposti un intervallo di prezzo.
  • Input dell'utente, ad esempio l'impostazione di una valutazione in una recensione.

Il cursore contiene una traccia, un cursore, un'etichetta del valore e dei segni di graduazione:

  • Traccia: la traccia è la barra orizzontale che rappresenta l'intervallo di valori che il cursore può assumere.
  • Cursore: il cursore è un elemento di controllo trascinabile sul cursore che consente all'utente di selezionare un valore specifico all'interno dell'intervallo definito dalla traccia.
  • Segni di graduazione: i segni di graduazione sono indicatori o marcatori visivi facoltativi che vengono visualizzati lungo la traccia del cursore.
Un cursore con pollice, traccia e segni di graduazione.
Figura 1. Implementazione di un cursore.

Implementazione di base

Per una definizione completa dell'API, consulta il riferimento Slider. Alcuni dei parametri chiave per il componente Slider sono i seguenti:

  • value: il valore attuale del cursore.
  • onValueChange: una funzione lambda che viene chiamata ogni volta che il valore viene modificato.
  • enabled: un valore booleano che indica se l'utente può interagire con il cursore.

L'esempio seguente è un semplice cursore. In questo modo, l'utente può selezionare un valore compreso tra 0.0 e 1.0. Poiché l'utente può selezionare qualsiasi valore in questo intervallo, il cursore è continuo.

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

Questa implementazione viene visualizzata nel seguente modo:

Un componente cursore con un valore selezionato a circa tre quarti della traccia.
Figura 2. Un'implementazione di base di un cursore.

Implementazione avanzata

Quando implementi uno slider più complesso, puoi utilizzare anche i seguenti parametri.

  • colors: un'istanza di SliderColors che ti consente di controllare i colori del cursore.
  • valueRange: l'intervallo di valori che il cursore può assumere.
  • steps: il numero di tacche sul cursore a cui si aggancia il cursore.

Il seguente snippet implementa un cursore con tre passaggi, con un intervallo da 0.0 a 50.0. Poiché il cursore si sposta su ogni passaggio, questo cursore è discreto.

@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

L'implementazione è la seguente:

Un cursore discreto con un intervallo da 0 a 50, che mostra cinque segni di graduazione a intervalli uguali. Il cursore è posizionato vicino al secondo segno di spunta, a indicare un valore selezionato di poco superiore a 16.
Figura 3. Un cursore con incrementi e un intervallo di valori impostato.

Cursore dell'intervallo

Puoi anche utilizzare il componente componibile RangeSlider dedicato. In questo modo l'utente può selezionare due valori. Ciò può essere utile in casi come quando l'utente vuole selezionare un prezzo minimo e massimo.

L'esempio seguente è un esempio relativamente semplice di un cursore continuo.

@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

Un componente cursore di intervallo con due valori selezionati. Un'etichetta mostra i limiti superiore e inferiore della selezione.
Figura 4. Implementazione di un cursore dell'intervallo.

Risorse aggiuntive