📜  科特林的离散SeekBar(1)

📅  最后修改于: 2023-12-03 15:11:25.810000             🧑  作者: Mango

科特林的离散SeekBar

科特林的离散SeekBar是一款适用于Android平台的离散进度条组件,它可以满足开发者在Android应用程序中显示离散进度条的需求。和普通的SeekBar不同,科特林的离散SeekBar将进度条的取值限制到了一组离散的数据集合中,开发者可以在自己的应用程序中根据特定场景设置不同的数据集合。

特性
  • 可以满足在应用程序中显示离散进度条的需求
  • 进度条取值限制在一组离散的数据集合中,可以根据特定场景设置不同的数据集合
  • 支持水平和垂直两种方向的进度条展示
  • 支持滑动条的样式自定义
安装方式

科特林的离散SeekBar可以通过在build.gradle文件中添加以下依赖项来完成安装:

compile 'com.kotlin-discrete-seekbar:discrete-seekbar:1.0.0'
使用方式
基本使用
  • 在XML中添加SeekBar组件

    <com.kotlin_discrete_seekbar.DiscreteSeekBar
        android:id="@+id/seekbar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:max="6"
        android:min="0"
        app:dsb_tickMarksCount="7" />
    
  • 在Activity中设置数据集合

    val data = listOf("0", "1", "2", "3", "4", "5", "6")
    val seekbar = findViewById<DiscreteSeekBar>(R.id.seekbar)
    seekbar.setDataSet(data)
    
自定义样式

可以通过在XML中定义自定义的样式,来改变滑动条的外观,例如:

<style name="CustomDiscreteSeekBarStyle">
  <item name="dsb_tickMarksSize">10dp</item>
  <item name="dsb_trackSize">16dp</item>
  <item name="dsb_thumbSize">16dp</item>
  <item name="dsb_thumbColor">@color/red</item>
</style>

然后在XML中将该样式应用到SeekBar中:

<com.kotlin_discrete_seekbar.DiscreteSeekBar
    android:id="@+id/seekbar"
    style="@style/CustomDiscreteSeekBarStyle"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:max="6"
    android:min="0"
    app:dsb_tickMarksCount="7" />
注意事项
  • 离散进度条的数据集合需要在使用前设置
  • 设置数据集合后,进度条最大值和最小值可以不用设置,程序自动根据数据集合的大小计算出最大值和最小值
示例代码

https://github.com/QuintonCO/kotlin-discrete-seekbar