滑桿

Slider 可讓使用者從多種不同的值中選擇。您可以使用滑桿讓使用者執行下列操作：

  • 調整使用值範圍的設定，例如音量和亮度。
  • 篩選圖表中的資料，例如設定價格範圍。
  • 使用者輸入內容，例如在評論中設定評分。

滑桿包含軌道、滑桿、值標籤和刻度標記：

  • 軌道：軌道是代表滑桿可取值範圍的水平長條。
  • Thumb：Thumb 是滑桿上的可拖曳控制元件，可讓使用者在軌道定義的範圍內選取特定值。
  • 刻度標記：刻度標記是選用的視覺標記或指標，會沿著滑桿軌跡顯示。
滑桿，包含滑桿指標、軌道和勾號。
圖 1. 滑桿的實作方式。

基本導入

如需完整的 API 定義，請參閱 Slider 參考資料。Slider 可組合項的一些重要參數如下：

  • value：滑桿的目前值。
  • onValueChange：每次變更值時都會呼叫的 lambda。
  • enabled：布林值，指出使用者是否能與滑桿互動。

以下範例是簡單的滑桿。這樣一來，使用者就能從 0.0 到 1.0 中選取值。由於使用者可以選取該範圍內的任何值，因此滑桿為連續。

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

此實作方式如下所示：

滑桿元件，其值選取了軌道上大約四分之三的範圍。
圖 2. 滑桿的基本實作方式。

進階導入

實作較複雜的滑桿時，您還可以使用下列參數。

  • colors：SliderColors 的例項，可用來控制滑桿的顏色。
  • valueRange：滑桿可取用的值範圍。
  • steps：滑桿上可用手指輕彈的刻痕數量。

以下程式碼片段會實作具有三個步驟的滑桿，範圍從 0.0 到 50.0。由於拇指會停在每個步驟，因此這個滑桿是不連續的。

@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

實作方式如下：

請在這裡輸入替代文字
圖 3. 滑桿含有步驟和設定值範圍。

範圍滑桿

您也可以使用專屬的 RangeSlider 可組合項。這可讓使用者選取兩個值。這在使用者想要選取最低和最高價格時，可能會很實用。

以下是連續範圍滑桿的簡單範例。

@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

範圍滑桿元件，已選取兩個值。標籤會顯示所選範圍的上限和下限。
圖 4. 範圍滑桿的實作方式。

其他資源