hlllmr1314 / timeline

瀑布流式的时间轴

TimeLine

This project aims to provide a easy way to use Staggered TimeLine implementation.

Provide the gradle dependency

compile 'com.vivian.widgets:TimeLineItemDecoration:1.0'

Usage

If you want to use this TimeLine in your project, you have to do the following.

• Set the StaggeredGridLayoutManager to your RecyclerView

mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(2, StaggeredGridLayoutManager.VERTICAL));

• Use the ItemDecoration of this project ItemDecoration.java

mRecyclerView.addItemDecoration(new ItemDecoration(this,100));

The second ctor-parameter will define the distance. In that case 100px.

Currently there are 2 styles available, as seen in the Screenshots. You can find the implementation for the second style here. DotItemDecoration.java

  DotItemDecoration mItemDecoration = new DotItemDecoration
                .Builder(this)
                .setItemStyle(DotItemDecoration.STYLE_DRAW)//choose to draw or use resource
                .setTopDistance(20)//dp
                .setItemInterVal(10)//dp
                .setItemPaddingLeft(10)//default value equals to item interval value
                .setItemPaddingRight(10)//default value equals to item interval value
                .setDotColor(Color.WHITE)
                .setDotRadius(2)//dp
                .setLineColor(Color.RED)//the color of vertical line
                .setLineWidth(1)//dp
                .setEndText("END")//set end text
                .setTextColor(Color.WHITE)
                .setTextSize(10)//sp
                .setDotPaddingText(2)//dp.The distance between the last dot and the end text
                .setBottomDistance(40)//you can add a distance to make bottom line longer
                .create();

if you want to do something according to the column of span,implements SpanIndexListener of this project SpanIndexListener.

   mItemDecoration.setSpanIndexListener(new SpanIndexListener() {
            @Override
            public void onSpanIndexChange(View view, int spanIndex) {
                view.setBackgroundResource(spanIndex == 0 ? R.drawable.pop_left : R.drawable.pop_right);
            }
   });

Example

License

Copyright 2017 Vivian

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.