Android轻量级网页风格分页器

2019-05-15 本文已影响9人 Owen_Lee

博客同步自:个人博客主页

轻量级仿网页风格分页器，和RecycleView封装一起配合使用，也可单独使用，喜欢就star、fork下吧～谢谢

功能介绍

[x] 支持延迟加载分页
[x] 支持单独分页器组件使用；同时封装了RecycleView，可以配合使用
[x] 支持加载状态改变提示
[x] 支持自定义数字指示器数量、选中和未选中等样式

效果图

pic1.png

pic2.png

Screenshots

pagination.gif

如何引入

Gradle引入

step 1

Add the JitPack repository to your build file

    allprojects {
            repositories {
                ...
                maven { url 'https://jitpack.io' }
            }
        }

Step 2

Add the dependency

dependencies {
             implementation 'com.github.itlwy:PaginationExample:0.0.20'
    }

简单使用

组合RecycleView使用

此时使用的是PaginationRecycleView类

activity_main.xml

...
<com.lwy.paginationlib.PaginationRecycleView
        android:id="@+id/pagination_rcv"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_marginBottom="8dp"
        app:number_tip_count="5"
        app:rect_size="30dp"
        app:selected_color="@color/indicator_rect_selected"
        app:text_size="14sp"
        app:unselected_color="@color/indicator_rect_unselected"
        />   
...

MainActivity.java

 ...
  @Override
    protected void onCreate(Bundle savedInstanceState) {
     mPaginationRcv = findViewById(R.id.pagination_rcv);
        mAdapter = new CustomAdapter(this, 99);
        mPaginationRcv.setAdapter(mAdapter);
//        mPaginationRcv.setPerPageCountChoices(perPageCountChoices);
        GridLayoutManager layoutManager = new GridLayoutManager(this, 3);
        mPaginationRcv.setLayoutManager(layoutManager);
        mPaginationRcv.setListener(new PaginationRecycleView.Listener() {
            @Override
            public void loadMore(int currentPagePosition, int nextPagePosition, int perPageCount, int dataTotalCount) {
                 // nextPagePosition为将要加载的页码，即需要加载数据的页
                 // perPageCount 每页展示的数量
               //TODO : 此处进行异步数据加载
               //TODO : 完成加载后通知分页控件(注意此处应该是在主线程运行)，如下
                mAdapter.setDatas(nextPagePosition, data);
                mPaginationRcv.setState(PaginationRecycleView.SUCCESS);
                
            }

            @Override
            public void onPerPageCountChanged(int perPageCount) {
             // "x条/每页"Spinner选中值改变时触发
            }
        });
        mAdapter.setOnItemClickListener(this);
 }
         @Override
    public void onItemClick(View view, RecyclerView.ViewHolder holder, int position) {
        JSONObject item = mAdapter.getCurrentPageItem(position);  // 此处position返回的是recycleview的位置，所以取当前页显示列表的项
        Toast.makeText(this, item.optString("name"), Toast.LENGTH_LONG).show();
    }
...

CustomAdapter

class CustomAdapter extends PaginationRecycleView.Adapter<JSONObject, ViewHolder> {


        private Context mContext;

        public CustomAdapter(Context context, int dataTotalCount) {
            super(dataTotalCount);
            mContext = context;
        }


        @Override
        public void bindViewHolder(ViewHolder viewholder, JSONObject data) {
            viewholder.setText(R.id.text, data.optString("name"));
        }

        @Override
        public ViewHolder createViewHolder(@NonNull ViewGroup parent, int viewTypea) {
            return ViewHolder.createViewHolder(mContext, parent, R.layout.item_list);
        }
    }

布局文件中的属性说明:

app:number_tip_count="5"   // 数字指示器显示的数量，默认是5
app:rect_size="30dp"     // 圆角矩形的大小(正方形)
app:selected_color="@color/indicator_rect_selected"  // 选中的颜色(包含框和字体)
app:text_size="14sp"  // 字体大小
app:unselected_color="@color/indicator_rect_unselected" 未选中的颜色(包含框和字体)

单独使用

此时使用的是PaginationIndicator类，布局如下：

...
<com.lwy.paginationlib.PaginationIndicator
    android:id="@+id/indicator"
    android:layout_width="match_parent"
    app:number_tip_count="5"
    app:rect_size="30dp"
    app:selected_color="@color/indicator_rect_selected"
    app:text_size="14sp"
    app:unselected_color="@color/indicator_rect_unselected"
    android:layout_height="wrap_content">
...

说明如上述

代码如下：

... 
private int[] perPageCountChoices = {10, 20, 30, 50};
... 
mIndicatorView = (PaginationIndicator) findViewById(R.id.indicator);
        mIndicatorView.setTotalCount(99);  // 设置数据源总数量即可
        mIndicatorView.setPerPageCountChoices(perPageCountChoices); // 选填
        mIndicatorView.setListener(new PaginationIndicator.OnChangedListener() {
            @Override
            public void onPageSelectedChanged(int currentPapePos, int lastPagePos, int totalPageCount, int total) {
                Toast.makeText(MainActivity.this, "选中" + currentPapePos + "页", Toast.LENGTH_LONG).show();
            }

            @Override
            public void onPerPageCountChanged(int perPageCount) {
                // x条/页 选项改变时触发
            }
        });
...

相关说明已在代码里注释，详细可参考demo，谢谢

依赖

recyclerview : com.android.support:recyclerview-v7:28.0.0

github地址

源码github
如果觉得对你有所帮助，就喜欢star一下表示下支持呗，谢啦各位看官～