Skip to content

shichaohui/AnimRefreshRecyclerView

Repository files navigation

AnimRefreshRecyclerViewDemo V1.0.3

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

带动画的下拉刷新RecyclerView

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

图中普通列表是ListView样式,没有设置Header和Footer,使用默认的下拉刷新和上拉加载。 宫格列表使用的是自定义Header和Footer的下拉刷新和上拉上拉加载,并设置了下拉使放大的图片。 瀑布流列表使用的是自定义Header和Footer的下拉刷新和上拉上拉加载,没有设置了下拉使放大的图片,使用默认的刷新动画。

用法:

Gradle:

dependencies {
    compile 'com.android.support:recyclerview-v7:23.1.0'
    compile 'com.sch.rfview:AnimRefreshRecyclerView:1.0.6@aar'
}

Eclipse的同学们可以自己下载源码拷贝java文件到自己的工程(别忘了引用RecyclerView的包哦)。 代码中的配置参考下面的用法代码片段,除了RecyclerView自带的方法,其他方法都是可选的。

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

// 使用重写后的线性布局管理器
mRecyclerView.setLayoutManager(new AnimRFLinearLayoutManager(context));

// 使用重写后的格子布局管理器
mRecyclerView.setLayoutManager(new AnimRFGridLayoutManager(context, 2));

// 使用重写后的瀑布流布局管理器
mRecyclerView.setLayoutManager(new AnimRFStaggeredGridLayoutManager(3, StaggeredGridLayoutManager.VERTICAL));

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

// 设置列表布局的分割线
mRecyclerView.addItemDecoration(new DividerItemDecoration(context,
        mAnimRFLinearLayoutManager.getOrientation(), true));

// 设置网格或者瀑布流布局的分割线
mRecyclerView.addItemDecoration(new DividerGridItemDecoration(context, true));

设置Header和Footer:

// 头部
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。

其他设置:

// 设置刷新动画的颜色(可选)
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();
    }
});

手动刷新

如果想第一次进入界面时就显示加载数据的动画,需要使用手动刷新的方法。此方法需要在其他设置完成后调用,具体使用可以看这里

mRecyclerView.setRefresh(true);

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

// 刷新完成后调用,必须在UI线程中
mRecyclerView.refreshComplate();
// 或者 刷新完成后调用,必须在UI线程中
mRecyclerView.setRefresh(false);

// 加载更多完成后调用,必须在UI线程中
mRecyclerView.loadMoreComplate();

禁止刷新

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

mRecyclerView.setRefreshEnable(false);

Tips:

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

About

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages