Skip to content

Latest commit

 

History

History
210 lines (135 loc) · 8.42 KB

recylerView.md

File metadata and controls

210 lines (135 loc) · 8.42 KB

RecyclerView

使用基础三要素

  1. 实现RecyclerView.Adapter<MyViewHolder>() 并且内部有list<Bean>并实现3个接口；

  2. 自定义MyViewHolder，简单的将findViewById搞定为全局变量

  3. 别忘记设置layoutManager

onBindViewHolder的2个区别

public abstract void onBindViewHolder(@NonNull VH holder, int position);
public void onBindViewHolder(@NonNull VH holder, int position,
                @NonNull List<Object> payloads)

一般情况，我们都是处理onBindViewHolder在初始化数据设置，或者notifyDataSetChanged() notifyItemChanged(int position)变化的时候处理；只有当我们调用了notifyItemChanged(int position, @Nullable Object payload) 进行一个itemView的部分控件更新。

就需要实现下面payloads这个函数。

Adapter的其他常用函数

onViewDetachedFromWindow： view贴上去。 onViewAttachedToWindow ：view下掉了。

LinearSnapHelper

itemDecoration

RecyclerView系列之一ItemDecoration_Luckie stone的博客-CSDN博客_recyclerview.state

  • PaddingItemDecoration

recyclerView的间隔。padding是用于最上面和最下面的位置；spacing是用于item之间的间距。

itemAnimator todo

todo。

DiffUtil

用来计算2个数列的差异。

DiffUtil.Callback：这是最核心的类,你可以将它理解成比较新老数据集时的规则。

DiffUtil：通过静态方法DiffUtil.calculateDiff(DiffUtil.Callback)来计算数据集的更新。

DiffResult：是DiffUtil的计算结果对象，通过DiffResult.dispatchUpdatesTo(RecyclerView.Adapter)来进行更新。

使用方式：

DiffUtil.DiffResult diffResult = DiffUtil.calculateDiff(new DiffCallBack(mDatas, newDatas), true);
//前面的计算可以做成异步，然后通过协程或者handler回到主线程即可。
mAdapter.setDatas(newDatas);
diffResult.dispatchUpdatesTo(mAdapter);

最后androidx库会帮你执行：

adapter.notifyItemRangeInserted(position, count);
adapter.notifyItemRangeRemoved(position, count);
adapter.notifyItemMoved(fromPosition, toPosition);
adapter.notifyItemRangeChanged(position, count, payload);
Callback用法和解释

接下来解释一下callback作为一个比较对象工具的处理。

 public abstract static class Callback {
     public abstract int getOldListSize();
     public abstract int getNewListSize();
     
     //判断是否是同一个Item。 
     public abstract boolean areItemsTheSame(int oldItemPosition, int newItemPosition);
     //如果是同一个Item，此方法用于判断是否同一个 Item 的内容也相同。
     public abstract boolean areContentsTheSame(int oldItemPosition, int newItemPosition);
     @Nullable
     public Object getChangePayload(int oldItemPosition, int newItemPosition) {
         return null;
     }
 }

areXXXTheSame()这2个方法，主要是为了对应多布局的情况产生的，也就是存在多个 viewType 和多个 ViewHodler 的情况。首先需要使用 areItemsTheSame() 方法比对是否来自同一个 viewType（也就是同一个 ViewHolder ） ，然后再通过 areContentsTheSame() 方法比对其内容是否也相等。

getChangePayload() 的方法，它可以在 ViewType 相同，但是内容不相同的时候，用 payLoad 记录需要在这个 ViewHolder 中，具体需要更新的View。

areItemsTheSame()、areContentsTheSame()、getChangePayload() 分别代表了不同量级的刷新。

首先会通过 areItemsTheSame() 判断当前 position 下，ViewType 是否一致，如果不一致就表明当前 position 下，从数据到 UI 结构上全部变化了，那么就不关心内容，直接更新就好了。如果一致的话，那么其实 View 是可以复用的，就还需要再通过 areContentsTheSame() 方法判断其内容是否一致，如果一致，则表示是同一条数据，不需要做额外的操作。但是一旦不一致，则还会调用 getChangePayload() 来标记到底是哪个地方的不一样，最终标记需要更新的地方，最终返回给 DiffResult 。

当然，对性能要是要求没那么高的情况下，是可以不使用 getChangedPayload() 方法的。

列头拉动效果(虚假的下拉刷新)todo

即，虚假的下拉刷新。

todo 今天必须完成。

下拉刷新或上拉刷新todo

todo 今天必须完成。

RecyclerView使用框架

参考rcv目录所有代码。

使用手册：

  • BindingRcvAdapter

    继承它实现recyclerView.Adapter，简易的adapter。内部封装了提交和更新的策略。

    1. 使用submitList或者submitListAsync更新数据。

    2. 如果想支持精细化更新items，实现createDiffer()和isSupportDiffer() = true

    3. 还有一些简易的addItems|removeItems等操作。

  • BindingLoadMoreRcvAdapter

    继承它实现recyclerView.Adapter。根据数据接口是否还有额外pages，显示可以加载更多的一种items类型。

    1. 不得使用submitList或者submitListAsync更新数据。
    2. 使用initDatas(datas: List<DATA>?, hasMore: Boolean)，appendDatas(appendList: List<DATA>?, hasMore: Boolean) 加载数据或者添加数据。其中hasMore就是为了在最底下显示是否有图标。
    3. 当滑动到底部，如果想立刻加载next页，则监听onScrollEndListener。并且onBindViewHolder不得取消super。

  • ViewHolder

    本人建议将数据bean设置到onCreateViewHolder的时候，设置到itemView上的tag。

    当click事件通过tag获取出数据，再行处理。

SpanSizeLookup

clipToPadding updatePadding

Margin Padding

initGridAdapterAndRcv(savedInstanceState: Bundle?,
                                   viewLifecycleOwner:LifecycleOwner,
                                   paddingLeft:Int = 7.5f.dp.toInt(), paddingRight:Int = 7.5f.dp.toInt(),
                                   decoration: RecyclerView.ItemDecoration = GridTwoDownItemDecoration(10.dp, 10.dp)
                ) {
        val rcv = pullView.recyclerView
        rcv.updatePadding(left = paddingLeft, right = paddingRight)
        pullView.layoutManager = GridLayoutManager(rcv.context, 2).also {
                //让loading变成占据2个。
                it.spanSizeLookup = object : GridLayoutManager.SpanSizeLookup() {
                    override fun getSpanSize(position: Int): Int {
                        if (!adapter.supportLoadMore()) return 1

                        return if (adapter is PullRefreshAndAutoLoadMore2Adapter && adapter.isLoadMoreHolder(position)) {
                            2 //如果是
                        } else {
                            1
                        }
                    }
                }
            }
rcv.addItemDecoration(decoration)
    

    /**
 * 两竖item往下的Grid排列方式
 * top表示两竖模式下的，两行之间的高度间隔；itemLeft是2个之间的距离。
 */
class GridTwoDownItemDecoration(private val top: Int, itemLeft: Int) : ItemDecoration() {
    private val itemLeft:Int
    init {
        this.itemLeft = itemLeft / 2
    }

    override fun getItemOffsets(outRect: Rect, view: View, parent: RecyclerView, state: RecyclerView.State) {
        val itemPosition = parent.getChildAdapterPosition(view)
        //进行左右分半，实现这个边距。否则，就会造成一边宽一边窄
        if (itemPosition % 2 == 1) {
            outRect.left = itemLeft
        } else {
            outRect.right = itemLeft
        }
        outRect.top = top
    }
}