StepView(流程,步骤)指示器

发表于 | 分类于

StepView

介绍

StepView是由自己公司开发的软件中抽取出来又做了强化,分为横向版和竖向版,颜色大小随意可调,灵活好用!

UI

Download Demo

Github

使用

Gradle

1
compile 'com.xyz.step:step:1.0.4'

Maven

1
2
3
4
5
6
<dependency>
  <groupId>com.xyz.step</groupId>
  <artifactId>step</artifactId>
  <version>1.0.4</version>
  <type>pom</type>
</dependency>

横向

属性介绍

属性 介绍 类型 默认 是否必须
h_bg_radius 背景 ○ 的半径 dimension 5 否
h_pro_radius 已完成 ○ 的半径 dimension 2 否
h_bg_width 背景线的宽度 dimension 3 否
h_bg_color 背景的颜色 color #cdcbcc 否
h_pro_width 已完成线的宽度 dimension 2 否
h_pro_color 已完成的颜色 color #029dd5 否
h_text_padding 步骤描述文字(title)与○的距离 dimension 10 否
h_time_padding 时间与○的距离 dimension 15 否
h_max_step 总步骤(○)的个数 int 5 否
h_pro_step 已完成步骤 int 1 否
h_textsize 字体大小 dimension 10 否

layout

1
2
3
4
5
6
7
8
9
10
11
12
<com.xyz.step.FlowViewHorizontal
        android:id="@+id/hflowview4"
        android:layout_width="match_parent"
        android:layout_height="80dp"
        android:paddingLeft="30dp"
        app:h_bg_radius="6dp"
        app:h_bg_width='4dp'
        app:h_pro_radius='4dp'
        app:h_pro_width="2dp"
        app:h_text_padding='10dp'
        app:h_textsize='10dp'
        app:h_time_padding='17dp' />

代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/**
 * 进度设置
 * @param progress 当前进行到哪一步
 * @param maxStep  总的步骤
 * @param titles   文字描述(指示线右侧)
 * @param times    时间描述(指示线左侧)
 */
public void setProgress(int progress, int maxStep, String[] titles, String[] times);


/**
     * 颜色设置 键值是步骤标题所包含的字符
     * @param map 标题-颜色
 */
public void setKeyColor(Map<String, String> map);

竖向

属性介绍

属性 介绍 类型 默认 是否必须
v_bg_radius 背景 ○ 的半径 dimension 5 否
v_pro_radius 已完成 ○ 的半径 dimension 2 否
v_bg_width 背景线的宽度 dimension 3 否
v_bg_color 背景的颜色 color #cdcbcc 否
v_pro_width 已完成线的宽度 dimension 2 否
v_pro_color 已完成的颜色 color #029dd5 否
v_interval ○ 与 ○之间的间距 dimension 80 否
v_bgPositionX 指示线距view左边缘的距离 dimension 100 否
v_textPaddingLeft 步骤描述文字与指示线的距离 dimension 10 否
v_timePaddingRight 时间与指示线的距离 dimension 15 否
v_max_step 总步骤(○)的个数 int 5 否
v_pro_step 已完成步骤 int 1 否
v_textsize 字体大小 dimension 10 否
v_textMoveTop 指示器右侧文字位置上下移动的距离 dimension 5 否
v_timeMoveTop 指示器左侧文字位置上下移动的距离 dimension 4 否

layout

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<com.xyz.step.FlowViewVertical
        android:id="@+id/vflow"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:paddingBottom="10dp"
        android:paddingRight="10dp"
        android:paddingTop="10dp"
        app:v_bgPositionX="40dp"
        app:v_bg_color="#029dd5"
        app:v_bg_radius="8dp"
        app:v_bg_width="4dp"
        app:v_interval="80dp"
        app:v_max_step="10"
        app:v_pro_color="#cdcbcc"
        app:v_pro_radius="8dp"
        app:v_pro_step="9"
        app:v_pro_width="4dp"
        app:v_textMoveTop="7dp"
        app:v_textsize="14dp" />

代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/**
 * 进度设置
 * @param progress 当前进行到哪一步
 * @param maxStep  总的步骤
 * @param titles   文字描述(指示线右侧)
 * @param times    时间描述(指示线左侧)
 */
public void setProgress(int progress, int maxStep, String[] titles, String[] times);


/**
     * 颜色设置 键值是步骤标题所包含的字符
     * @param map 标题-颜色
 */
public void setKeyColor(Map<String, String> map);

使用注意

全部

  • title[] 和 time[] 传null 的时候则不显示指示器不显示文字与时间
  • 最小步骤总和(max_step)>=2且>=已完成步骤(pro_step)
  • 字体大小单位是dp
  • 具体步骤颜色的设置是根据步骤描述(title[])中是否包含所传入map的key值来决定是否更改的,注意是”包含”
  • 只有已完成步骤才可以单独设置颜色,未完成步骤统一使用的是bg_color所得到的颜色

横向

  • 横向指示器自动计算步骤之间的间隔
  • 横向指示器自动居中显示,当设定paddingLeft后无需再设定paddingRight
  • 横向指示器不可以横向滑动

竖向

  • 竖向指示器需单独设置步骤之间的间隔(v_interval)
  • 竖向指示器可与ScrollView结合使用,从而达到滑动
  • 竖向指示器并没有使用item复用,如果数据量较大建议使用listview
  • 竖向指示器绘制文字有所不同,也因此导致文字与步骤节点(○)不在一个水平线上,可通过v_textMoveTop与v_timeMoveTop适配

LICENSE 开源协议

Apache License Version 2.0