RecyclerView列表控件漂亮时间线实现

蔚落 2022-07-15 15:57 161阅读 0赞

时间都去哪了；时间你走慢一点吧

很多软件中都有时间线的东西，比如天气，计划，旅游等时间线最多了；具体实现方式很多，在本篇文章中讲解一种自定义View封装的方式实现时间线效果，PS：这也是面试中也时常会问到的知识点

# **1. 效果图** #

![1440469250572021.png][]

# **2. 实现分析** #

软件中，可以看见前面的时间线也就是线条加上圆圈组成；当然这里的圆圈与线条也都是可以随意换成其他的，比如图片等等。

当然这里最简单的来说，是上面一个线条，然后一个圆圈，然后下面一个线条；上线条在第一条数据时不做显示，下线条在最后一条数据时不做显示。

![自定义控件][1440469277121276.png]

这里自定义布局部分也就是把旁边的线条与圆圈封装到一起，并使用简单的方法来控制是否显示。

当封装好了后，与旁边的文字部分也就是水瓶方向的线性布局了，然后设置为每一个的RecyclerView 的Item的布局也就完成了。

# **3. 自定义控件** #

控件很简单，首先我们继承View，取名为 TimeLineMarker 就OK。

## **3.1 自定义属性** ##

开始控件之前先准备好需要的属性。

<?xml version="1.0" encoding="utf-8"?>
    <resources>
        <declare-styleable name="TimeLineMarker">
            <attr name="markerSize" format="dimension" />
            <attr name="marker" format="color|reference" />
            <attr name="beginLine" format="color|reference" />
            <attr name="endLine" format="color|reference" />
            <attr name="lineSize" format="dimension" />
        </declare-styleable>
    </resources>

在这里也就准备了线条的大小、开始线条、结束线条、中间标示部分及大小。

## **3.2 属性与实现** ##

private int mMarkerSize = 24;
        private int mLineSize = 12;
        private Drawable mBeginLine;
        private Drawable mEndLine;
        private Drawable mMarkerDrawable;
    
        @Override
        protected void onDraw(Canvas canvas) {
            if (mBeginLine != null) {
                mBeginLine.draw(canvas);
            }
    
            if (mEndLine != null) {
                mEndLine.draw(canvas);
            }
    
            if (mMarkerDrawable != null) {
                mMarkerDrawable.draw(canvas);
            }
    
            super.onDraw(canvas);
        }

两个大小属性，3个具体的Drawable，然后在onDraw方法中进行具体的显示也就OK。

## **3.3 构造与属性初始化** ##

在上面我们定义了属性，在这里我们在构造函数中获取XML所设置的属性。

public TimeLineMarker(Context context) {
            this(context, null);
        }
    
        public TimeLineMarker(Context context, AttributeSet attrs) {
            this(context, attrs, 0);
        }
    
        public TimeLineMarker(Context context, AttributeSet attrs, int defStyle) {
            super(context, attrs, defStyle);
            init(attrs);
        }
    
        private void init(AttributeSet attrs) {
            // Load attributes
            final TypedArray a = getContext().obtainStyledAttributes(
                    attrs, R.styleable.TimeLineMarker, 0, 0);
    
            mMarkerSize = a.getDimensionPixelSize(
                    R.styleable.TimeLineMarker_markerSize,
                    mMarkerSize);
    
            mLineSize = a.getDimensionPixelSize(
                    R.styleable.TimeLineMarker_lineSize,
                    mLineSize);
    
            mBeginLine = a.getDrawable(
                    R.styleable.TimeLineMarker_beginLine);
    
            mEndLine = a.getDrawable(
                    R.styleable.TimeLineMarker_endLine);
    
            mMarkerDrawable = a.getDrawable(
                    R.styleable.TimeLineMarker_marker);
    
            a.recycle();
    
            if (mBeginLine != null)
                mBeginLine.setCallback(this);
    
            if (mEndLine != null)
                mEndLine.setCallback(this);
    
            if (mMarkerDrawable != null)
                mMarkerDrawable.setCallback(this);
        }

## **3.4 Drawable 的位置与大小初始化** ##

属性啥的有了，具体的Drawable 也有了，要显示的地方调用也是OK了；但是如果没有进行进行具体的位置调整这一切也都没有意义。

@Override
        protected void onSizeChanged(int w, int h, int oldw, int oldh) {
            super.onSizeChanged(w, h, oldw, oldh);
            initDrawableSize();
        }
    
        private void initDrawableSize() {
            int pLeft = getPaddingLeft();
            int pRight = getPaddingRight();
            int pTop = getPaddingTop();
            int pBottom = getPaddingBottom();
    
            int width = getWidth();
            int height = getHeight();
    
            int cWidth = width - pLeft - pRight;
            int cHeight = height - pTop - pBottom;
    
            Rect bounds;
    
            if (mMarkerDrawable != null) {
                // Size
                int markerSize = Math.min(mMarkerSize, Math.min(cWidth, cHeight));
                mMarkerDrawable.setBounds(pLeft, pTop,
                        pLeft + markerSize, pTop + markerSize);
    
                bounds = mMarkerDrawable.getBounds();
            } else {
                bounds = new Rect(pLeft, pTop, pLeft + cWidth, pTop + cHeight);
            }
    
    
            int halfLineSize = mLineSize >> 1;
            int lineLeft = bounds.centerX() - halfLineSize;
    
            if (mBeginLine != null) {
                mBeginLine.setBounds(lineLeft, 0, lineLeft + mLineSize, bounds.top);
            }
    
            if (mEndLine != null) {
                mEndLine.setBounds(lineLeft, bounds.bottom, lineLeft + mLineSize, height);
            }
        }

initDrawableSize 方法进行具体的运算，而运算的时间点就是当控件的大小改变（onSizeChanged）的时候。  
在初始化中采用了一定的投机取巧；这里利用了上内边距与下内边距分别作为上线条与下线条的长度；而线条与中间的标识都采用了水平距中。

## **3.5 其他设置方法** ##

public void setLineSize(int lineSize) {
            if (mLineSize != lineSize) {
                this.mLineSize = lineSize;
                initDrawableSize();
                invalidate();
            }
        }
    
        public void setMarkerSize(int markerSize) {
            if (this.mMarkerSize != markerSize) {
                mMarkerSize = markerSize;
                initDrawableSize();
                invalidate();
            }
        }
    
        public void setBeginLine(Drawable beginLine) {
            if (this.mBeginLine != beginLine) {
                this.mBeginLine = beginLine;
                if (mBeginLine != null) {
                    mBeginLine.setCallback(this);
                }
                initDrawableSize();
                invalidate();
            }
        }
    
        public void setEndLine(Drawable endLine) {
            if (this.mEndLine != endLine) {
                this.mEndLine = endLine;
                if (mEndLine != null) {
                    mEndLine.setCallback(this);
                }
                initDrawableSize();
                invalidate();
            }
        }
    
        public void setMarkerDrawable(Drawable markerDrawable) {
            if (this.mMarkerDrawable != markerDrawable) {
                this.mMarkerDrawable = markerDrawable;
                if (mMarkerDrawable != null) {
                    mMarkerDrawable.setCallback(this);
                }
                initDrawableSize();
                invalidate();
            }
        }

在设置中，首先判断是否更改，如果更改那么就更新并重新计算位置；随后刷新界面。

到这里，控件差不多准备OK了，其中还有很多可以完善的地方，比如加上快捷设置颜色什么的，也可以加上大小计算的东西。同时还可以加上时间线是水瓶还是垂直等等。在这里就不累赘介绍哪些了。下面来看看如何使用。

## **3.6 使用XML布局ITEM布局item\_time\_line.xml** ##

<?xml version="1.0" encoding="utf-8"?>
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="wrap_content" android:orientation="horizontal" android:paddingLeft="@dimen/lay_16" android:paddingRight="@dimen/lay_16" tools:ignore="MissingPrefix">
    
        <net.qiujuer.example.timeline.widget.TimeLineMarker android:id="@+id/item_time_line_mark" android:layout_width="wrap_content" android:layout_height="match_parent" android:paddingBottom="@dimen/lay_16" android:paddingLeft="@dimen/lay_4" android:paddingRight="@dimen/lay_4" android:paddingTop="@dimen/lay_16" app:beginLine="@color/black_alpha_32" app:endLine="@color/black_alpha_32" app:lineSize="2dp" app:marker="@drawable/ic_timeline_default_marker" app:markerSize="24dp" />
    
        <TextView android:id="@+id/item_time_line_txt" android:layout_width="match_parent" android:layout_height="wrap_content" android:layout_gravity="center" android:paddingBottom="@dimen/lay_16" android:paddingLeft="@dimen/lay_4" android:paddingRight="@dimen/lay_4" android:paddingTop="@dimen/lay_16" android:textColor="@color/grey_600" android:textSize="@dimen/font_16" />
    
    </LinearLayout>

在这里我们之间使用顺序布局，左边是TimelIne控件，右边是一个简单的字体控件，具体使用中可以细化一些。

在TImeLine控件中我们的Mark是使用的drawable/ic\_timeline\_default\_marker；这个就是一个简单的圆圈而已；对于自己美化可以使用一张图片代替或者更加复杂的布局；当然上面的线条就更加简单了，就直接使用颜色代替。

<?xml version="1.0" encoding="utf-8"?>
    <shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="oval">
        <solid android:color="@color/cyan_500" />
        <stroke android:width="1dp" android:color="@color/black_alpha_32" />
    </shape>

## **3.7 主界面XML RecyclerView** ##

在这里就是加上了一个RecyclerView 控件在主界面就OK。

# **4. Java代码部分** #

在开始之前先来看看我们的文件具体有些神马。

![1440469609114998.png][]

widget中就是具体的自定义控件，model是具体的数据模型，adapter部分，这里有一个Recyclerview的adapter文件，以及一个具体的Item TimeLineViewHolder，当然在这里还定义了一个ItemType类，该类用来标示每个Item的类型，比如头部，第一个，普通，最后一个，底部等等。

## **4.1 TimeLineModel.java** ##

package net.qiujuer.example.timeline.model;
    
    public class TimeLineModel { 
        private String name;
        private int age;
    
        public TimeLineModel() {
    
        }
    
        public TimeLineModel(String name, int age) {
            this.name = name;
            this.age = age;
        }
    
        public int getAge() {
            return age;
        }
    
        public String getName() {
            return name;
        }
    
        public void setAge(int age) {
            this.age = age;
        }
    
        public void setName(String name) {
            this.name = name;
        }
    }

一个名字，一个年龄。

## **4.2 ItemType.java** ##

package net.qiujuer.example.timeline.adapter;
    
    public class ItemType { 
        public final static int NORMAL = 0;
    
        public final static int HEADER = 1;
        public final static int FOOTER = 2;
    
        public final static int START = 4;
        public final static int END = 8;
    
        public final static int ATOM = 16;
    }

分别定义了几个静态值，分别代表普通、头部、底部、开始、结束、原子；当然其中有些可以不用定义。

## **4.3 TimeLineViewHolder.java** ##

package net.qiujuer.example.timeline.adapter;
    
    import android.support.v7.widget.RecyclerView;
    import android.view.View;
    import android.widget.TextView;
    import net.qiujuer.example.timeline.R;
    import net.qiujuer.example.timeline.model.TimeLineModel;
    import net.qiujuer.example.timeline.widget.TimeLineMarker;
    
    public class TimeLineViewHolder extends RecyclerView.ViewHolder { 
        private TextView mName;
    
        public TimeLineViewHolder(View itemView, int type) {
            super(itemView);
    
            mName = (TextView) itemView.findViewById(R.id.item_time_line_txt);
    
            TimeLineMarker mMarker = (TimeLineMarker) itemView.findViewById(R.id.item_time_line_mark);
            if (type == ItemType.ATOM) {
                mMarker.setBeginLine(null);
                mMarker.setEndLine(null);
            } else if (type == ItemType.START) {
                mMarker.setBeginLine(null);
            } else if (type == ItemType.END) {
                mMarker.setEndLine(null);
            }
    
        }
    
        public void setData(TimeLineModel data) {
            mName.setText("Name:" + data.getName() + " Age:" + data.getAge());
        }
    }

该文件为RecyclerView 的Adapter中每个Item需要实现的Holder类。  
在该类中，我们在构造函数中需要传入一个根View同时传入一个当然item的状态。

随后使用find….找到控件，在这里我们把TextView保存起来，而TimeLineView找到后直接进行初始化设置。

根据传入的ItemType来判断是否是第一个，最后一个，以及原子；然后设置TimeLineView的属性。

在下面的setData方法中我们显示具体的Model数据。

## **4.4 TimeLineAdapter.java** ##

适配器部分，我们需要做的工作是；根据具体的数据渲染上对应的界面。

package net.qiujuer.example.timeline.adapter;
    
    import android.support.v7.widget.RecyclerView;
    import android.view.LayoutInflater;
    import android.view.View;
    import android.view.ViewGroup;
    import net.qiujuer.example.timeline.R;
    import net.qiujuer.example.timeline.model.TimeLineModel;
    import java.util.List;
    
    public class TimeLineAdapter extends RecyclerView.Adapter<TimeLineViewHolder> { 
        private List<TimeLineModel> mDataSet;
    
        public TimeLineAdapter(List<TimeLineModel> models) {
            mDataSet = models;
        }
    
        @Override
        public int getItemViewType(int position) {
            final int size = mDataSet.size() - 1;
            if (size == 0)
                return ItemType.ATOM;
            else if (position == 0)
                return ItemType.START;
            else if (position == size)
                return ItemType.END;
            else return ItemType.NORMAL;
        }
    
        @Override
        public TimeLineViewHolder onCreateViewHolder(ViewGroup viewGroup, int viewType) {
            // Create a new view.
            View v = LayoutInflater.from(viewGroup.getContext())
                    .inflate(R.layout.item_time_line, viewGroup, false);
            return new TimeLineViewHolder(v, viewType);
        }
    
        @Override
        public void onBindViewHolder(TimeLineViewHolder timeLineViewHolder, int i) {
            timeLineViewHolder.setData(mDataSet.get(i));
        }
    
        @Override
        public int getItemCount() {
            return mDataSet.size();
        }
    }

在这里需要着重说一下：我复写了getItemViewType()方法；在该方法中我们需要设置对应的Item的类型；在这里传入的是item的坐标，需要返回的是item的具体状态，该状态标示是int类型；在这里我使用的是ItemType的静态属性。

该方法会在调用onCreateViewHolder方法之前调用；而onCreateViewHolder方法中的第二个参数int值也就是从getItemViewType之中来；所以我们可以在这里进行对应的数据状态标示。

而在onCreateViewHolder()方法中我们返回一个：TimeLineViewHolder就OK，随后在onBindViewHolder方法中进行数据初始化操作。

## **4.5 MainActivity.java** ##

上面所有都准备好了，下面就进行具体的显示。 在这里就只贴出核心代码了；篇幅也是有些长。

private RecyclerView mRecycler;
    
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
    
            mRecycler = (RecyclerView) findViewById(R.id.time_line_recycler);
            initRecycler();
        }
    
        private void initRecycler() {
            LinearLayoutManager layoutManager = new LinearLayoutManager(this);
            layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
    
            TimeLineAdapter adapter = new TimeLineAdapter(getData());
    
            mRecycler.setLayoutManager(layoutManager);
            mRecycler.setAdapter(adapter);
        }
    
        private List<TimeLineModel> getData() {
            List<TimeLineModel> models = new ArrayList<TimeLineModel>();
    
            models.add(new TimeLineModel("XiaoMing", 21));
            models.add(new TimeLineModel("XiaoFang", 20));
            models.add(new TimeLineModel("XiaoHua", 25));
            models.add(new TimeLineModel("XiaoA", 22));
            models.add(new TimeLineModel("XiaoNiu", 23));
    
            return models;
        }

在这里就是傻瓜的操作了，流程就是准备好对应的数据，装进Adapter，准备好对应的布局方式，然后都设置到RecyclerView中就OK

![1440469865127253.png][]

效果虽然简单，但是也算是五脏具全；其中无非就是控件的自定义。这个自定义是可以扩展的，大家可以扩展为水平方向试试。

GitHub地址：[https://github.com/qiujuer/BeFoot][https_github.com_qiujuer_BeFoot]

# 5. UPMiss #

GitHub地址：[https://github.com/qiujuer/UPMiss][https_github.com_qiujuer_UPMiss]

![自定义控件][2919F7A6A7C72293A1F0289D0C9CAA48]

原文出处：[http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0825/3364.html][http_www.jcodecraeer.com_a_anzhuokaifa_androidkaifa_2015_0825_3364.html]

[1440469250572021.png]: http://www.jcodecraeer.com/uploads/20150825/1440469250572021.png
[1440469277121276.png]: http://www.jcodecraeer.com/uploads/20150825/1440469277121276.png
[1440469609114998.png]: http://www.jcodecraeer.com/uploads/20150825/1440469609114998.png
[1440469865127253.png]: http://www.jcodecraeer.com/uploads/20150825/1440469865127253.png
[https_github.com_qiujuer_BeFoot]: https://github.com/qiujuer/BeFoot
[https_github.com_qiujuer_UPMiss]: https://github.com/qiujuer/UPMiss
[2919F7A6A7C72293A1F0289D0C9CAA48]: http://res.qiujuer.net/res/2919F7A6A7C72293A1F0289D0C9CAA48
[http_www.jcodecraeer.com_a_anzhuokaifa_androidkaifa_2015_0825_3364.html]: http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0825/3364.html