IndicatorSeekBar 技术文档

安装指南

为了在您的Android项目中使用IndicatorSeekBar库，您需要执行以下步骤：

添加依赖

在您的项目的build.gradle（Module级别）文件中的dependencies块内加入以下Gradle依赖：

dependencies {
    implementation 'com.github.warkiz.widget:indicatorseekbar:2.1.2'
}

之后同步Gradle项目，使依赖生效。

项目使用说明

IndicatorSeekBar是一个高度可定制的SeekBar控件，提供进度指示器、刻度显示以及多种样式配置。

XML布局

在XML布局文件中直接使用IndicatorSeekBar标签，并通过属性定制其外观和行为：

<com.warkiz.widget.IndicatorSeekBar
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:isb_max="100"
    app:isb_progress="50"
    .../>

Java代码配置

您也可以在Java代码中创建并配置IndicatorSeekBar实例：

IndicatorSeekBar seekBar = IndicatorSeekBar
    .with(this) // 这里的this指上下文
    .max(100)
    .progress(50)
    ...
    .build();

项目API使用文档

设置指示器文本格式

您可以自定义指示器显示的文本，比如添加百分比符号：

seekBar.setIndicatorTextFormat("${PROGRESS}%");

指示器始终保持可见

通过嵌入IndicatorStayLayout使指示器在滑动时保持位置不变：

<com.warkiz.widget.IndicatorStayLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
    <com.warkiz.widget.IndicatorSeekBar
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:isb_show_indicator="rectangle"/>
</com.warkiz.widget.IndicatorStayLayout>

自定义轨道颜色

可以为SeekBar的不同部分设置不同的轨道颜色：

seekBar.customSectionTrackColor(new ColorCollector() {
    @Override
    public boolean collectSectionTrackColor(int[] colorIntArr) {
        // 设置每个段落的颜色
        colorIntArr[0] = ContextCompat.getColor(this, R.color.section1);
        colorIntArr[1] = ContextCompat.getColor(this, R.color.section2);
        ...
        return true;
    }
});

属性配置

IndicatorSeekBar提供了众多XML属性来定制化控件，详情参考项目中的attr.xml文件。

监听进度变化

实现OnSeekChangeListener以监听SeekBar进度的变化：

seekBar.setOnSeekChangeListener(new OnSeekChangeListener() {
    @Override
    public void onSeeking(SeekParams seekParams) {
        // 处理实时进度变化
    }

    @Override
    public void onStartTrackingTouch(IndicatorSeekBar seekBar) {
        // 开始拖动时调用
    }

    @Override
    public void onStopTrackingTouch(IndicatorSeekBar seekBar) {
        // 结束拖动时调用
    }
});

至此，您已经掌握了集成和基本使用IndicatorSeekBar的方法。更多高级功能和定制化选项，请参考项目源码和示例应用。