一个简单的时间线控件,采用 RecyclerView 实现,无任何三方依赖库,一个纯净的库

TimeLine

项目地址:rangaofei/TimeLine 

简介:simple timeline

更多:作者   提 Bug   

标签:

 

一个简单的时间线控件,采用 RecyclerView 实现,无任何三方依赖库,一个纯净的库。主要特性:

  1. 可定制 timeline 的 icon 图标,每个图标可以通过 list 作为参数传入
  2. 可定制 item 布局,每个 item 中的 view 都可通过 anchor 注解来设置不同的 style
  3. 支持时间线的前景色和后景色,采用 src_in 方式覆盖
  4. 时间线进度可随意控制,可以实现 10%,15%,96%等进度
  5. 采用编译期注解,在运行期未使用反射
  6. 支持四种时间线位置,item 大小不同时会自动进行位置对齐。比如时间线在上方,所有的 item 会自动顶部对齐。
  7. 支持三种时间线模式

看两张效果图,仿淘宝退款,和一个不太标准的仿慕课:

 

0.2.4 更新:

新增可以控制 icon 大小的属性:

app:timeLineIconHeight="30dp"
app:timeLineIconWidth="30dp"

新增样式

app:strokeType="midEndPoint"

如图:

未设置该大小时会自动设置成为 timePadding 的三分之二;当其中一个设置另一个未设置时, 未设置的值会自动设置成为已设置的值。

可以设置 dividerNum 为浮点型,会自动调整进度,这种形式在 noEndPoint 模式下工作最好。

集成方式

    implementation 'com.rangaofei:sakatimeline:0.2.4'
    annotationProcessor 'com.rangaofei:JavaTimeLine:0.2.4'

然后修改 app 级别的 module 的 build.gradle 文件:

android {

    defaultConfig {

        //省略代码
        javaCompileOptions{
            annotationProcessorOptions.includeCompileClasspath=true
        }
    }
}

假如没出现问题的话就集成成功了

使用 StepView

StepView 基于注解

StepView 内部使用 apt 处理注解实现了 adapter,adapter 包含两种布局,key 和 value。目前推出的只需要使用 value 布局即可。

首先要定义一个 model,这个 model 要编写一些注解

@TimeLine(valueLayoutId = "R.layout.item_value")
public class StepViewModel {

    @TimeLineTextView(key = false, value = "R.id.value")
    public String text;

    public StepViewModel(String text) {
        this.text = text;
    }

    public String getText() {
        return text;
    }

    public void setText(String text) {
        this.text = text;
    }
}

注意,每个变量必须采用 public 修饰,否则获取不到变量的值(其实是目前我没有做任何 getter 和 setter 方法)

然后先 build 一次,在需要使用 model 的时候要写入

private AbstractTimeLineAdapter adapter;

private List<StepViewModel> stepViewModels = new ArrayList<>();

系统会自动生成一个 StepViewModelViewAdapter 文件,这个 adapter 需要传入一个 list 作为数据源, 这个 list 中的 item 类型必须设置为被标注为 TimeLine 的类。

stepViewModels.add(new StepViewModel("快递发出"));
stepViewModels.add(new StepViewModel("快递签收"));
stepViewModels.add(new StepViewModel("快递丢失"));
adapter = new StepViewModelAdapter(stepViewModels);
binding.tlv.setTimeLineConfig(adapter, TimeLineType.StepViewType.RIGHT_STEP_PROGRESS);

这样我们就完成了基本设置。 运行可以看到效果图:

 

展开阅读全文

没有更多推荐了,返回首页