# HorizontalPage

**Repository Path**: JoJun/HorizontalPage

## Basic Information

- **Project Name**: HorizontalPage
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-09-18
- **Last Updated**: 2021-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# HorizontalPage
一行代码让RecyclerView变身ViewPager
#序言

我曾经写过一个[使用RecycleView打造水平分页GridView](http://blog.csdn.net/qq_22706515/article/details/52266641)。当时用到的是对数据的重排序，但是这样处理还是有些问题，比如用户数据更新以后还需要继续重排序，包括对滑动事件的处理也不是很好。当时主要因为时间比较匆忙，写的不是很好，这一次我将采用自定义LayoutManger的方式实现水平分页的排版，使用一个工具类实现一行代码就让RecycleView具有分页滑动的特性。

#效果

1.水平分页的效果(采用了自定义LayoutManger+滑动工具类实现)，关键是不需要修改Adapter，可以用来实现表情列表，或者是商品列表。

![这里写图片描述](http://img.blog.csdn.net/20161115152537126)

2.垂直方向的分页显示，可以实现读报的功能，或者其他需要一页一页阅读的功能，采用了LinearLayoutManger+滑动工具类实现，比使用LinearLayout布局的优势在于实现了View的复用。

![这里写图片描述](http://img.blog.csdn.net/20161115152758593)

3.水平分页，这是使用LinearLayoutManger+分页滑动工具类实现的，这样LinearLayout就可以横向的一页一页显示，用这个实现Banner要比ViewPager要简单很多，性能也会有所提高。因为ViewPager自己并没有缓存机制。

![这里写图片描述](http://img.blog.csdn.net/20161115153028518)

其实还可以实现很多其他的功能，限于我的想象力有限就先举这些例子吧。

#使用

1.要想数据按一页一页的排列就使用HorizontalPageLayoutManager，在构造方法中传入行数和列数就行了
```java
   //构造HorizontalPageLayoutManager,传入行数和列数
   horizontalPageLayoutManager = new HorizontalPageLayoutManager(3,4);
   //这是我自定义的分页分割线，样式是每一页的四周没有分割线。大家喜欢可以拿去用
   pagingItemDecoration = new PagingItemDecoration(this, horizontalPageLayoutManager);

```
2.分页滚动，上一步的HorizontalPageLayoutManager只负责Item分页的排列和回收，而要实现分页滚动需要使用PagingScrollHelper 这个工具类。注意这个工具类很强的，使用其他的LayoutManger也可以和这个工具类共同使用实现分页效果。

```
  PagingScrollHelper scrollHelper = new PagingScrollHelper();
  scrollHelper.setUpRecycleView(recyclerView);
  //设置页面滚动监听
  scrollHelper.setOnPageChangeListener(this);
```
滑动监听类

```

    public interface onPageChangeListener {
        void onPageChange(int index);
    }
```
**注意**

1。用于使用了RecyclerView的OnFlingListener，所以RecycleView的版本必须要25以上。

![这里写图片描述](http://img.blog.csdn.net/20161115154731900)

2。如果想使用自定义的LayoutManger实现分页滑动，则必须实现LayoutManger的这两个方法之一，因为工具类是通过这两个方法判断应该怎么滚动的。

```

        /**
         * Query if horizontal scrolling is currently supported. The default implementation
         * returns false.
         *
         * @return True if this LayoutManager can scroll the current contents horizontally
         */
        public boolean canScrollHorizontally() {
            return false;
        }

        /**
         * Query if vertical scrolling is currently supported. The default implementation
         * returns false.
         *
         * @return True if this LayoutManager can scroll the current contents vertically
         */
        public boolean canScrollVertically() {
            return false;
        }
```

----------
#2018-02-27 更新

1.解决需要点击两次才能刷新的bug（感谢评论区里面的小伙伴）
2.提供滚动到指定页面的方法，可以配合数据刷新。

```
	   myAdapter.notifyDataSetChanged();
        //滚动到第一页
        scrollHelper.scrollToPosition(0);
```
3.提供获取总页数的方法。目前支持的有LinearLayoutManager，StaggeredGridLayoutManager，HorizontalPageLayoutManager（我自己写的）,如果你想自己的LayoutManger也能获取到总页数，请实现相应的方法。
下面三个是能横向滚动的LayoutManger,能竖直滚动的有对应的三个方法。

```
  @Override
    public int computeHorizontalScrollRange(RecyclerView.State state) {
       return 0;
    }

    @Override
    public int computeHorizontalScrollOffset(RecyclerView.State state) {
        return 0;
    }

    @Override
    public int computeHorizontalScrollExtent(RecyclerView.State state) {
        return 0;
    }
```
获取总页数的方法

```
 //获取总页数,采用这种方法才能获得正确的页数。否则会因为RecyclerView.State 缓存问题，页数不正确。
 //第一次，和每一次更新adapter以后。需要使用这样的方法获取。
        recyclerView.post(new Runnable() {
            @Override
            public void run() {
                tv_page_total.setText("共" + scrollHelper.getPageCount() + "页");
            }
        });
```

最后的最后，感谢小伙伴的支持。没想到这几百行的小工具这么收欢迎。大家还有bug，欢迎反馈。