建立可用於多個值的滑桿

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

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

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

  • 軌道:軌道是代表滑桿可取值範圍的水平長條。
  • Thumb:Thumb 是滑桿上的可拖曳控制項元件,可讓使用者在軌道定義的範圍內選取特定值。
  • 刻度標記:刻度標記是沿著滑桿軌跡顯示的選用視覺標記或指標。

本主題將說明下列滑桿實作方式:

版本相容性

這個實作方式需要將專案 minSDK 設為 API 級別 21 以上。

依附元件

建立基本滑桿

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

結果

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

建立進階滑桿

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

結果

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

範圍滑桿

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

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

結果

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

重點

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

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

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

  • colorsSliderColors 的例項,可讓您控制滑桿的顏色。
  • valueRange:滑桿可用的值範圍。
  • steps:滑桿上可用手指輕彈的刻痕數量。

您也可以將 Slider 傳遞至 thumbtrack 可組合項,進一步自訂元件的外觀。

包含此指南的集合

本指南是精選的快速指南系列之一,涵蓋更廣泛的 Android 開發目標:

瞭解可組合函式如何讓您輕鬆根據 Material Design 設計系統,建立美觀的 UI 元件。

有問題或意見回饋嗎?

歡迎前往常見問題頁面,瞭解快速指南或與我們聯絡,分享您的想法。