Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/shichaohui/AnimRefreshRecyclerView

下拉刷新和上拉加载更多的RecyclerView，具有下拉和刷新动画。
https://github.com/shichaohui/AnimRefreshRecyclerView

Last synced: 1 day ago
JSON representation

下拉刷新和上拉加载更多的RecyclerView，具有下拉和刷新动画。

Lists

README 

        
# AnimRefreshRecyclerViewDemo V1.0.3



效果预览，嗯...看起来有点卡，截图软件的问题



![带动画的下拉刷新RecyclerView](http://img.blog.csdn.net/20150808145428151)



**上图中演示了三种不同的布局和下拉效果，三种布局和三种下拉效果可以通过Header的设置任意组合。**



图中普通列表是ListView样式，没有设置Header和Footer，使用默认的下拉刷新和上拉加载。

宫格列表使用的是自定义Header和Footer的下拉刷新和上拉上拉加载，并设置了下拉使放大的图片。

瀑布流列表使用的是自定义Header和Footer的下拉刷新和上拉上拉加载，没有设置了下拉使放大的图片，使用默认的刷新动画。



### 用法：

Gradle:

```xml

dependencies {

    compile 'com.android.support:recyclerview-v7:23.1.0'

    compile 'com.sch.rfview:AnimRefreshRecyclerView:1.0.6@aar'

}

```

Eclipse的同学们可以自己下载源码拷贝java文件到自己的工程（别忘了引用RecyclerView的包哦）。

代码中的配置参考下面的用法代码片段，除了RecyclerView自带的方法，其他方法都是可选的。



#### 根据列表的不同效果选择不同的布局管理器：

```java

// 使用重写后的线性布局管理器

mRecyclerView.setLayoutManager(new AnimRFLinearLayoutManager(context));



// 使用重写后的格子布局管理器

mRecyclerView.setLayoutManager(new AnimRFGridLayoutManager(context, 2));



// 使用重写后的瀑布流布局管理器

mRecyclerView.setLayoutManager(new AnimRFStaggeredGridLayoutManager(3, StaggeredGridLayoutManager.VERTICAL));

```



#### 根据不同的布局管理器设置分割线：

```java

// 设置列表布局的分割线

mRecyclerView.addItemDecoration(new DividerItemDecoration(context,

        mAnimRFLinearLayoutManager.getOrientation(), true));



// 设置网格或者瀑布流布局的分割线

mRecyclerView.addItemDecoration(new DividerGridItemDecoration(context, true));

```



#### 设置Header和Footer：

```java

// 头部

headerView = LayoutInflater.from(context).inflate(R.layout.header_view, null);

// 脚部

footerView = LayoutInflater.from(context).inflate(R.layout.footer_view, null);



// 添加头部和脚部，如果不添加就使用默认的头部和脚部（头部可以有多个）

mRecyclerView.addHeaderView(headerView);

// 设置头部的最大拉伸倍率，默认1.5f，必须写在setHeaderImage()之前

mRecyclerView.setScaleRatio(2.0f);

// 设置下拉时拉伸的图片，不设置就使用默认的

mRecyclerView.setHeaderImage((ImageView) headerView.findViewById(R.id.iv_hander));

mRecyclerView.addFootView(footerView);

```

可以通过`addHeaderView()`和`setHeaderImage()`方法任意组合下拉效果，可以调用多次`addHeaderView()`方法添加多个头部，但是`setHeaderImage()`方法最多被调用一次。

最多调用一次`addFootView()`方法，即最多设置一个FooterView。



#### 其他设置：

```java

// 设置刷新动画的颜色（可选）

mRecyclerView.setColor(Color.RED, Color.WHITE);

// 设置头部恢复动画的执行时间，默认500毫秒（可选）

mRecyclerView.setHeaderImageDurationMillis(1200);

// 设置拉伸到最高时头部的透明度，默认0.5f（可选）

mRecyclerView.setHeaderImageMinAlpha(0.6f);



// 设置适配器

mRecyclerView.setAdapter(new MyAdapter());



// 设置刷新和加载更多数据的监听，分别在onRefresh()和onLoadMore()方法中执行刷新和加载更多操作

mRecyclerView.setLoadDataListener(new AnimRFRecyclerView.LoadDataListener() {

    @Override

    public void onRefresh() {

	    // 开启线程刷新数据

        new Thread(new MyRunnable()).start();

    }



    @Override

    public void onLoadMore() {

	    // 开启线加载更多数据

        new Thread(new MyRunnable()).start();

    }

});

```



#### 手动刷新

如果想第一次进入界面时就显示加载数据的动画，需要使用手动刷新的方法。此方法需要在其他设置完成后调用，具体使用可以[看这里](https://github.com/shichaohui/AnimRefreshRecyclerView/blob/master/app/src/main/java/com/sch/rfview/example/fragment/LinearFragment.java)

```java

mRecyclerView.setRefresh(true);

```



#### 在刷新和加载过更多完成之后调用代码停止动画：

```java

// 刷新完成后调用，必须在UI线程中

mRecyclerView.refreshComplate();

// 或者 刷新完成后调用，必须在UI线程中

mRecyclerView.setRefresh(false);



// 加载更多完成后调用，必须在UI线程中

mRecyclerView.loadMoreComplate();

```



#### 禁止刷新

如果不想使用自带的刷新效果，而想要使用SwipRefreshLayout做刷新，可使用以下代码禁止自带的刷新效果

```

mRecyclerView.setRefreshEnable(false);

```



**Tips：**



* 若在使用过程中发现adapter.notifyDataSetChange()等更新数据的方法无效，可使用recyclerView.getAdapter()获取当前使用的Adapter，并使用获取到到Adapter更新数据。