Kotlin超簡單實現StepView

TimeLineStepView

支持時間軸和StepView，三種佈局，支持水平佈局，垂直佈局和自定義佈局，截圖以下

添加依賴

implementation 'com.joketng:TimeLineStepView:1.0.1'
複製代碼

使用方法

• 在佈局文件中添加TimeLineStepView

<com.joketng.timelinestepview.view.TimeLineStepView
        android:id="@+id/rvVertical"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:lineWidth="3dp"
        app:markSize="10dp"
        android:paddingStart="20dp"
        app:markStart="@drawable/shape_circle_orange"
        app:layoutType="right"
        />
複製代碼

• 在代碼中調用

//OrientationShowType對應三種佈局方式
//OrientationShowType.TIMELINE(時間軸方式)
//OrientationShowType.CENTER_VERTICAL(垂直方式)
//OrientationShowType.CENTER_HORIZONTAL(水平方式，支持左右滑動)
rvVertical.initData(listContent, OrientationShowType.CENTER_VERTICAL,
                object : TimeLineStepView.OnInitDataCallBack{
                    override fun onBindDataViewHolder(holder: TimeLineStepAdapter.CustomViewHolder, position: Int) {
                        
                    }

                    override fun createCustomView(leftLayout: ViewGroup, rightLayout: ViewGroup, holder: TimeLineStepAdapter.CustomViewHolder) {
                         //LayoutInflater.from(context).inflate(R.layout.item_add_left_view, leftLayout, true)
                         //LayoutInflater.from(context).inflate(R.layout.item_add_right_view, rightLayout, true)
                    }

                })
                .setLayoutType(type)//設置佈局顯示的樣式左邊：LayoutType.LEFT,右邊：LayoutType.RIGHT,左右：LayoutType.ALL
                //設置stepview進度激活的mark圖標
                .setMarkActive(ContextCompat.getDrawable(context,R.drawable.shape_dot_orange)!!)
                //設置stepview進度沒激活的mark圖標
                .setMarkInActive(ContextCompat.getDrawable(context,R.drawable.shape_dot_gray)!!)
                //設置stepview當前進度點的mark圖標
                .setMarkCurrent(ContextCompat.getDrawable(context,R.drawable.shape_current)!!)
                //設置stepview第一個mark的圖標
                .setMarkStart(ContextCompat.getDrawable(context,R.drawable.shape_circle_orange)!!)
                //設置stepview最後一個mark的圖標
                .setMarkEnd(ContextCompat.getDrawable(context,R.drawable.shape_circle_orange)!!)
                //設置stepview線的寬度
                .setLineWidth(context.dipc(2))
                //設置stepview進度激活時線的顏色
                .setLineActiveColor(ContextCompat.getColor(context,R.color.c_main_orange))
                //設置stepview進度沒有激活時線的顏色
                .setLineInActiveColor(ContextCompat.getColor(context,R.color.c_main_gray))
                //設置是否須要自定義佈局(此時將createCustomView中的註釋打開將自定義佈局傳入)
                .setIsCustom(true)
                
複製代碼

listContent的取值爲 mutableListOf()，當存在自定義佈局的時候，listContent中添加的實體須要繼承BaseBean這個實體，若是不須要自定義佈局，能夠直接添加實體BaseBean

listContent.add(BaseBean(leftTitle = "11-11", leftTime = "08:30", rightTitle = "訂單提交成功", rightTime = "訂單提交成功描述", timeLineState = TimeLineState.ACTIVE))
        listContent.add(BaseBean(leftTitle = "11-11", leftTime = "08:31", rightTitle = "訂單付款成功", rightTime = "訂單付款成功描述", timeLineState = TimeLineState.ACTIVE))
        listContent.add(BaseBean(leftTitle = "11-11", leftTime = "10:00", rightTitle = "倉庫已經接單", rightTime = "倉庫已經接單描述", timeLineState = TimeLineState.ACTIVE))
        listContent.add(BaseBean(leftTitle = "11-11", leftTime = "10:30", rightTitle = "倉庫處理中", rightTime = "倉庫處理中描述", timeLineState = TimeLineState.ACTIVE))
        listContent.add(BaseBean(leftTitle = "11-11", leftTime = "11:00", rightTitle = "已出庫", rightTime = "已出庫描述", timeLineState = TimeLineState.ACTIVE))
        listContent.add(BaseBean(leftTitle = "11-11", leftTime = "11:30", rightTitle = "已發貨", rightTime = "已發貨描述", timeLineState = TimeLineState.CURRENT))
        listContent.add(BaseBean(leftTitle = "11-11", leftTime = "16:00", rightTitle = "已攬件", rightTime = "已攬件描述", timeLineState = TimeLineState.INACTIVE))
        listContent.add(BaseBean(leftTitle = "11-11", leftTime = "16:30", rightTitle = "運輸中", rightTime = "運輸中描述", timeLineState = TimeLineState.INACTIVE))
複製代碼

BaseBean的五個參數前四個爲控件的文本,前四個參數不傳的話該控件就不會顯示,最後一個TimeLineState對應進度的三種狀態TimeLineState.ACTIVE，TimeLineState.INACTIVE，TimeLineState.CURRENT，根據狀態在onBindDataViewHolder方法中設置markdrawable，linecolor等,在設置markSize的時候，若是大小超過30dp,須要在createCustomView方法或者onBindDataViewHolder方法中調用holder.llLine.layoutParams.width設置爲大於等於markSize的大小或者設置爲WrapContent，以下

holder.llLine.layoutParams.width = context.dip(35)
holder.llLine.layoutParams.width = LinearLayout.LayoutParams.WRAP_CONTENT
複製代碼

對於佈局的顯示位置有要求的話能夠在createCustomView方法中經過layoutParams來控制

val rightLayoutParams = rightLayout.layoutParams as LinearLayout.LayoutParams
rightLayoutParams.rightMargin = context.dip(30)
複製代碼

若是不喜歡在代碼中設置控件屬性的話能夠選擇佈局文件中增長屬性

<com.joketng.timelinestepview.view.TimeLineStepView
          android:id="@+id/rvVertical"
          android:layout_width="match_parent"
          android:layout_height="wrap_content"
          android:paddingStart="20dp"
          app:markSize="10dp"
          app:markStart="@drawable/shape_circle_orange"
          app:markEnd="@drawable/shape_circle_orange"
          app:markActive="@drawable/shape_dot_orange"
          app:markInActive="@drawable/shape_dot_gray"
          app:markCurrent="@drawable/shape_circle_orange"
          app:lineWidth="3dp"
          app:lineActiveColor="@color/c_main_orange"
          app:lineInActiveColor="@color/c_main_gray"
          app:isCustom="false"
          app:layoutType="right"
          />
複製代碼

若是須要能夠在onBindDataViewHolder方法中經過holder獲取控件改變控件的樣式，若是想要添加自定義的UI，能夠在createCustomView方法中添加本身定義的佈局文件，此時調用setIsCustom(true)便可

rvVertical.initData(listContent, OrientationShowType.CENTER_VERTICAL,
                   object : TimeLineStepView.OnInitDataCallBack{
                       override fun onBindDataViewHolder(holder: TimeLineStepAdapter.CustomViewHolder, position: Int) {
                           holder.tvRightTitle.setTextColor(ContextCompat.getColor(context, R.color.c_main_black))
                           holder.tvLeftTitle.setTextColor(ContextCompat.getColor(context, R.color.c_main_black))
                           holder.tvRightTime.textSize = 12f
                           holder.tvLeftTime.textSize = 12f
                           holder.tvRightTime.setTextColor(ContextCompat.getColor(context, R.color.c_main_gray))
                           holder.tvLeftTime.setTextColor(ContextCompat.getColor(context, R.color.c_main_gray))
                       }
   
                       override fun createCustomView(leftLayout: ViewGroup, rightLayout: ViewGroup, holder: TimeLineStepAdapter.CustomViewHolder) {
                            LayoutInflater.from(context).inflate(佈局id, leftLayout, true)//添加左邊自定義佈局
                            LayoutInflater.from(context).inflate(佈局id, rightLayout, true)//添加右邊自定義佈局

                       }
   
                   }).setLayoutType(type).setIsCustom(true)
複製代碼

自定義佈局的一個截圖以下

• 傳送門Github Demo

使用Maven

<dependency>
  <groupId>com.joketng</groupId>
  <artifactId>TimeLineStepView</artifactId>
  <version>1.0.1</version>
  <type>pom</type>
</dependency>
複製代碼

聯繫方式

若是有什麼問題，我沒有及時回覆的話，能夠加我qq542490039，或者發郵件到joketng@163.com，我看到以後會回覆的。