PowerRecyclerView

作者: androidproject 发布时间: 2019-09-08 浏览: 2584 次 编辑

PowerRecyclerView使用

PullRefresh.gif

Build Status API Android Arsenal Download

快速使用

implementation 'com.lovejjfg.powerrecycle:powerrecycle:lastedVersion'

因为 lib 已经依赖了 v7 和 RecyclerView ,当前版本是 27 ,可以移除。

implementation ('com.lovejjfg.powerrecycle:powerrecycle:1.2.6'){
    exclude group: 'com.android.support', module: 'appcompat-v7'
    exclude group: 'com.android.support', module: 'recyclerview-v7'
}

V1.0.0

  • 实现下拉刷新加载更多

V1.0.1

  • 加载更多适配GridLayoutManager

  • 添加单选和多选模式

V1.0.2

  • 更名 SwipRefreshRecycleView 为 PowerRecyclerView

  • 更名 RefreshRecycleAdapter 为 PowerAdapter

  • 如果不需要下拉刷新 ,Adapter 可直接适配 RecycleView

  • 可直接通过 PowerRecyclerView 设置点击、选择事件的回调

  • 水平方向的 ScrollBar 修复

  • 修复拖拽排序存在的bug

  • 增加移除某个Item和添加Item的方法

V1.0.3

  • PowerAdapter 修复构造方法

V1.2.0

  • 废除了 PowerRecyclerView ,如果需要使用 SwipeRefreshLayout 请自己手动添加,聚合比组合更加灵活,如果需要自定义下拉刷新 Header ,可以使用 PowerRefresh  

  • 在点击回调方法中增加Item的返回。

  • 增加了 PowerHolder 作为默认的 Holder

  • 增加设置 错误页面 和 空白页面 的两个方法

V1.2.6

  • 移除 lambda

  • setLoadMoreView() 方法参数改为接收 布局资源id

  • LoadMoreScrollListener 在 attachRecyclerView() 中自动设置,并不对外暴露

  • onBottomViewHolderBind() 修改,增加 listener

  • DefaultAnimator 废除,理论上不需要再设置这个解决相关crash。

V2.0.0

bugfix:

  1. 默认 loadingmore 的 loading 状态显示异常

  2. 调用 updateLoadingMore() 方法更新 加载更多 状态异常

  3. Kotlin 中,data class 使用时,选择状态异常

  4. 加载更多刷新状态异常

PowerAdapter changes:

  1. attachRecyclerView() 废除,直接使用 recyclerView.setAdapter() 即可

  2. setLoadMoreView() 废除,新增 createLoadMoreView()

  3. setEmptyView() 废除,新增 createEmptyView()

  4. setErrorView() 废除,新增 createErrorView()

  5. 新增 onViewHolderBind(@NonNull PowerHolder<T> holder, int position, @NonNull List<Object> payloads) 支持局部刷新

  6. itemClick itemLongClick 回调方法参数调整(view -> PowerHolder)

  7. 新增 updateItem() 用于刷新 Item.

  8. enableLoadMore 默认为 true 并且私有化

SelectPowerAdapter changes:

  1. 实现接口 AdapterSelect

  2. OnItemSelectedListener.onItemSelectChange(@NonNull PowerHolder<S> holder, int position, boolean isSelected)参数变化

  3. 新增 setCurrentPos(int position) setCurrentPositions(@NonNull int... position) 两方法设置默认选中 items(注意,setList() 方法目前并不会直接触发选择状态)

  4. 新增 getMaxSelectCount() 和 onReceivedMaxSelectCount(int count) 控制最大选择数量

  5. 新增 deleteSelectedItems() 移除选中items

  6. 新增 revertAllSelected() 反选 items 反选上限受 getMaxSelectCount() 影响

PowerHolder changes:

  1. 新增 onPartBind(@NonNull T t, @NonNull List<Object> payloads) 和 onPartBind(@NonNull T t, boolean isSelectMode, @NonNull List<Object> payloads) 用于局部数据刷新

Examples

0、创建:(Adapter 继承 RefreshRecycleAdapter)

    mRecycleView.setLayoutManager(new LinearLayoutManager(this));
    mRecycleView.setAdapter(adapter);
    mRecycleView.setOnRefreshListener(this);
    adapter = new MyRecycleAdapter();
    adapter.setLoadMoreListener(this);
    adapter.setTotalCount(10);

1、创建自己对应的布局的方法:

RecyclerView.ViewHolder onViewHolderCreate(ViewGroup parent, int viewType);

void onViewHolderBind(RecyclerView.ViewHolder holder, int position);

2、加载更多的几种状态的更改:

boolean isHasMore();//是否还有更多,可以自己实现具体的逻辑!

void isLoadingMore();

void loadMoreError();

3、自定义加载更多的布局:

void setLoadMoreView(View view);

RecyclerView.ViewHolder onBottomViewHolderCreate(View loadMore);

void onBottomViewHolderBind(RecyclerView.ViewHolder holder, int loadState);

4、添加数据源相关的方法,提供了set和append两种方式:

void setList(List<T> data);

void appendList(List<T> data);

@Override
public final void appendList(List<T> data) {
    int positionStart = list.size();
    list.addAll(data);
    int itemCount = list.size() - positionStart;

    if (positionStart == 0) {
        notifyDataSetChanged();
    } else {
        notifyItemRangeInserted(positionStart + 1, itemCount);
    }
}

5、点击 选择模式,及相关回调:

mRecycleView.setOnItemClickListener(new AdapterLoader.OnItemClickListener() {
    @Override
    public void onItemClick(View itemView, int position) {
        toast.setText("点击了:" + position);
        toast.show();
    }
});

adapter.setSelectedMode(AdapterLoader.SingleMode);
adapter.updateSelectMode(true);
adapter.setOnItemSelectListener(new AdapterLoader.OnItemSelectedListener() {
    @Override
    public void onItemSelected(View view, int position, boolean isSelected) {
        Log.e("TAG", "onItemSelected: " + position + "::" + isSelected);
    }

    @Override
    public void onNothingSelected() {
        Log.e("TAG", "onNothingSelected: ");
    }
});

6、GridLayoutManager设置SpanSize

    mRecycleView.setSpanSizeCallBack(new SwipeRefreshRecycleView.SpanSizeCallBack() {
        @Override
        public int getSpanSize(int position) {
            return 1;
        }
    });

7、使用SpacesItemDecoration添加上下左右留白

/**
 *
 * @param space item之间的空间
 * @param count 列数
 * @param showEdge 是否显示左右边缘
 */
public SpacesItemDecoration(int space, int count, boolean showEdge) {
    this.spacing = space;
    this.spanCount = count;
    this.showEdge = showEdge;
    pre = spacing * 1.0f / spanCount;
}

decor = new SpacesItemDecoration(30, 3, true);
mRecycleView.getRecycle().addItemDecoration(decor);

8、拖拽排序

    //初始化一个TouchHelperCallback
    TouchHelperCallback callback = new TouchHelperCallback();
    //添加一个回调
    callback.setItemDragSwipeCallBack(adapter);
    //初始化一个ItemTouchHelper
    ItemTouchHelper itemTouchHelper = new ItemTouchHelper(callback);
    //关联相关的RecycleView
    itemTouchHelper.attachToRecyclerView(mRecycleView.getRecycle());

9、自定义加载更多

//1、指定对应布局
adapter.setLoadMoreView(LayoutInflater.from(this).inflate(R.layout.layout_foot_self, mRecycleView, false));

//2、创建对应的Holder 实现Adapter中的两个方法
@Override
public RecyclerView.ViewHolder onBottomViewHolderCreate(View loadMore) {
    return new BottomViewHolder(loadMore);
}

@Override
public void onBottomViewHolderBind(RecyclerView.ViewHolder holder, int loadState) {
    ((BottomViewHolder) holder).onBind(getLoadMoreListener(), loadState);
}

PS:直接使用RecyclerView请注意添加mRecycleView.setItemAnimator(new DefaultAnimator());

因为有使用 lambda ,所以你可能需要指定 Java 的版本:

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

混淆

-dontwarn com.lovejjfg.**

博客地址

Android RecycleView轻松实现下拉刷新、加载更多

Android RecyclerView 定制单选多选模式

Android 打造专属的下拉刷新 加载更多

编译不过?!

项目使用

Readhub


项目地址:https://github.com/lovejjfg/PowerRecyclerView