Android轻量级网页风格分页器

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

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

目录

  • 功能介绍
  • 效果图
  • 如何引入
  • 简单使用
  • 依赖
  • github地址

功能介绍

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

效果图

Android轻量级网页风格分页器_第1张图片

Android轻量级网页风格分页器_第2张图片

Screenshots

如何引入

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类

  1. 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"
            />	
    ...
    
  2. 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();
        }
    ...
    
  3. 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一下表示下支持呗,谢啦各位看官~

你可能感兴趣的:(Android)