美文网首页
RecyclerView详解

RecyclerView详解

作者: kjy_112233 | 来源:发表于2018-01-31 11:42 被阅读0次

在RecyclerView中封装了ViewHolder的回收复用,将ViewHolder标准化;通过LayoutManager设置布局显示方式;通过ItemDecoration设置布局分割线;通过ItemAnimator设置添加和删除item的动画效果;RecyclerView本身是不提供点击、长按事件。

一、RecyclerView使用

(1)导入支持的库

dependencies {
    compile 'com.android.support:recyclerview-v7:28.0.1'
}

(2)布局文件

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <android.support.v7.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</RelativeLayout>

(3)布局管理器

  • LinearLayoutManager:线性布局管理器
//orientation:设置布局方向
//reverseLayout:是否设置逆向布局
LinearLayoutManager(context)
LinearLayoutManager(context, orientation, reverseLayout)
  • GridLayoutManager:网格布局管理器
//spanCount:设置行数或列数
//orientation:设置布局方向
//reverseLayout:是否设置逆向布局
GridLayoutManager(context, spanCount)
GridLayoutManager(context, spanCount,orientation, reverseLayout)
  • StaggeredGridLayoutManager:瀑布流布局管理器
//spanCount:设置行数或列数
//orientation:设置布局方向
StaggeredGridLayoutManager(spanCount, orientation)

(4)adapter中的代码实现

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {

    private Context context;
    private List<String> list;
    private LayoutInflater inflater;
    private MyAdapter.MyItemClickListener mItemClickListener;

    public MyAdapter(Context context, List<String> list) {
        this.inflater = LayoutInflater.from(context);
        this.list = list;
        this.context = context;
    }

    //创建ViewHolder
    @Override
    public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View view = inflater.inflate(R.layout.layout_item, parent, false);
        MyAdapter.ViewHolder viewHolder = new MyAdapter.ViewHolder(view, mItemClickListener);
        return viewHolder;
    }

    //向item中添加数据
    @Override
    public void onBindViewHolder(MyAdapter.ViewHolder holder, int position) {
        holder.tv_name.setText(list.get(position));
    }

    //返回item个数
    @Override
    public int getItemCount() {
        return list.size();
    }

    //填充视图、设置点击事件。
    public static class ViewHolder extends RecyclerView.ViewHolder implements View.OnClickListener {
        public MyAdapter.MyItemClickListener myItemClickListener;
        private TextView tv_name;

        public ViewHolder(View itemView, MyAdapter.MyItemClickListener myItemClickListener) {
            super(itemView);
            this.myItemClickListener = myItemClickListener;
            itemView.setOnClickListener(this);
            tv_name = itemView.findViewById(R.id.tv_name);
        }

        @Override
        public void onClick(View v) {
            if (myItemClickListener != null) {
                myItemClickListener.onItemClick(v, getPosition());
            }
        }
    }

    public interface MyItemClickListener {
        void onItemClick(View view, int position);
    }

    //通过实现接口处理点击事件
    public void setItemClickListener(MyAdapter.MyItemClickListener myItemClickListener) {
        this.mItemClickListener = myItemClickListener;
    }

    //添加数据
    public void onItemAdd(int position) {
        list.add(position, "position");
        notifyItemInserted(position);
    }

    //移除数据
    public void onItemRemove(int position) {
        list.remove(position);
        notifyItemRemoved(position);
    }

    //移动时交换位置
    public void onItemMove(int fromPosition, int toPosition) {
        Collections.swap(list, fromPosition, toPosition);
    }
}

(5)代码中实现

recyclerView = findViewById(R.id.recycler_view);
LayoutManager layoutManager = new LinearLayoutManager(this, LinearLayoutManager.VERTICAL, true);
recyclerView.setLayoutManager(layoutManager);//设置管理器
recyclerView.setAdapter(adapter)//添加adapter
recyclerView.setItemAnimator(new DefaultItemAnimator());//设置删除、添加动画
recyclerView.addItemDecoration(new DividerItemDecoration(getActivity(), 
  DividerItemDecoration.HORIZONTAL_LIST));//设置分割线

adapter.onItemRemove(1);//删除数据
adapter.onItemAdd(0);//添加数据
recyclerView.scrollToPosition(0);//解决添加无动画

二、加载不同布局的item

  • 修改adapter中的代码
public class MyAdapter extends RecyclerView.Adapter {

    private Context context;
    private List<Data> list;
    private LayoutInflater inflater;
    private MyAdapter.MyItemClickListener mItemClickListener;

    public MyAdapter(Context context, List<String> list){
        this.inflater = LayoutInflater.from(context);
        this.list = list;
        this.context = context;
    }

    //创建ViewHolder
    @Override
    public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        switch (viewType){
            case 0:
                View view_0 = inflater.inflate(R.layout.layout_item_0, parent, false);
                ViewHolder0 viewHolder0 = new ViewHolder0(view_0, mItemClickListener);
                return viewHolder0;
            case 1:
                View view = inflater.inflate(R.layout.layout_item_1, parent, false);
                ViewHolder1 viewHolder1 = new ViewHolder1(view_1, mItemClickListener);
                return viewHolder1;
        }
        return null;
    }

    //向item中添加数据
    @Override
    public void onBindViewHolder(MyAdapter.ViewHolder holder, int position) {
        int type = list.get(position).getType();
        switch (type){
            case 0:
                ViewHolder0 holder0= (ViewHolder0) holder;
                holder0.tv_name.setText(list.get(position).name);
                break;
            case 1:
                ViewHolder1 holder1= (ViewHolder1) holder;
                holder1.tv_name.setText(list.get(position).name);
                break;
        }
    }

    //返回item个数
    @Override
    public int getItemCount() {
        return list.size();
    }

    //返回viewHolder的类型
    @Override
    public int getItemViewType(int position) {
        return list.get(position).getType;
    }

    //填充视图、设置点击事件。
    public static class ViewHolder0 extends RecyclerView.ViewHolder implements View.OnClickListener {
        public MyAdapter.MyItemClickListener myItemClickListener;
        private TextView tv_name;
        public ViewHolder0(View itemView, MyAdapter.MyItemClickListener myItemClickListener) {
            super(itemView);
            this.myItemClickListener = myItemClickListener;
            itemView.setOnClickListener(this);
            tv_name = itemView.findViewById(R.id.tv_name);
        }

        @Override
        public void onClick(View v) {
            if (myItemClickListener != null) {
                myItemClickListener.onItemClick(v, getPosition());
            }
        }
    }

    public static class ViewHolder1 extends RecyclerView.ViewHolder implements View.OnClickListener {
        public MyAdapter.MyItemClickListener myItemClickListener;
        private TextView tv_name;
        public ViewHolder1(View itemView, MyAdapter.MyItemClickListener myItemClickListener) {
            super(itemView);
            this.myItemClickListener = myItemClickListener;
            itemView.setOnClickListener(this);
            tv_name = itemView.findViewById(R.id.tv_name);
        }

        @Override
        public void onClick(View v) {
            if (myItemClickListener != null) {
                myItemClickListener.onItemClick(v, getPosition());
            }
        }
    }

    public interface MyItemClickListener {
        void onItemClick(View view, int position);
    }

    //通过实现接口处理点击事件
    public void setItemClickListener(MyAdapter.MyItemClickListener myItemClickListener) {
        this.mItemClickListener = myItemClickListener;
    }
}

三、侧滑删除、长按拖动

(1)自定义的类继承ItemTouchHelper.Callback抽象类

public class RecyclerItemTouchCallback extends ItemTouchHelper.Callback {
    private MyAdapter adapter;
    private boolean isLongPressDragEnabled = true;
    private boolean isItemViewSwipeEnabled = true;

    public RecyclerItemTouchCallback(MyAdapter adapter) {
        this.adapter = adapter;
    }

    public RecyclerItemTouchCallback(MyAdapter adapter, boolean isLongPressDragEnabled, boolean isItemViewSwipeEnabled) {
        this.adapter = adapter;
        this.isLongPressDragEnabled = isLongPressDragEnabled;
        this.isItemViewSwipeEnabled = isItemViewSwipeEnabled;
    }

    @Override
    public int getMovementFlags(@NonNull RecyclerView recyclerView, @NonNull RecyclerView.ViewHolder viewHolder) {
        int dragFlags, swipeFlags;
        RecyclerView.LayoutManager layoutManager = recyclerView.getLayoutManager();
        if (layoutManager instanceof GridLayoutManager || layoutManager instanceof StaggeredGridLayoutManager) {
            //设置拖动的方向
            dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN | ItemTouchHelper.LEFT | ItemTouchHelper.RIGHT;
            swipeFlags = 0;
        } else {
            //设置拖动的方向
            dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN;
            //表示滑动的方向
            swipeFlags = ItemTouchHelper.START | ItemTouchHelper.END;
        }
        //值传0,表示不支持该功能
        return makeMovementFlags(dragFlags, swipeFlags);
    }

    //拖拽过程中调用
    @Override
    public boolean onMove(@NonNull RecyclerView recyclerView, @NonNull RecyclerView.ViewHolder viewHolder, @NonNull RecyclerView.ViewHolder target) {
        //判断viewType是否相同
        int fromPosition = viewHolder.getAdapterPosition();
        int toPosition = target.getAdapterPosition();
        if (!isLongPressDragEnabled && toPosition == 0) {
            return false;
        }
        if (fromPosition < toPosition) {
            //途中所有的item位置都要移动
            for (int i = fromPosition; i < toPosition; i++) {
                //调用adapter方法移动数据
                adapter.onItemMove(i, i + 1);
            }
        } else {
            for (int i = fromPosition; i > toPosition; i--) {
                //调用adapter方法移动数据
                adapter.onItemMove(i, i - 1);
            }
        }
        adapter.notifyItemMoved(fromPosition, toPosition);
        return true;
    }

    //滑动移除的方法
    @Override
    public void onSwiped(@NonNull RecyclerView.ViewHolder viewHolder, int direction) {
        //调用adapter删除数据并更新
        adapter.onItemRemove(viewHolder.getAdapterPosition());
    }

    //给选中的item添加背景颜色
    @Override
    public void onSelectedChanged(@Nullable RecyclerView.ViewHolder viewHolder, int actionState) {
        if (actionState == ItemTouchHelper.ACTION_STATE_DRAG) {
            //拖拽状态背景颜色
            assert viewHolder != null;
            viewHolder.itemView.setBackgroundColor(Color.BLUE);
        } else if (actionState == ItemTouchHelper.ACTION_STATE_SWIPE) {
            //滑动删除状态背景颜色
            assert viewHolder != null;
            viewHolder.itemView.setBackgroundColor(Color.RED);
        }
        super.onSelectedChanged(viewHolder, actionState);
    }

    //恢复选中item背景
    @Override
    public void clearView(@NonNull RecyclerView recyclerView, @NonNull RecyclerView.ViewHolder viewHolder) {
        viewHolder.itemView.setBackgroundColor(Color.TRANSPARENT);
        super.clearView(recyclerView, viewHolder);
    }

    //是否支持长按拖动
    @Override
    public boolean isLongPressDragEnabled() {
        return isLongPressDragEnabled;
    }

    //是否支持滑动操作
    @Override
    public boolean isItemViewSwipeEnabled() {
        return isItemViewSwipeEnabled;
    }
}

(2)代码中实现

ItemTouchHelper itemTouchHelper = new ItemTouchHelper(new RecyclerItemTouchCallback(adapter));
itemTouchHelper.attachToRecyclerView(recyclerView);

四、自定义分割线

(1)自定义分割线

  • 查看ItemDecoration源码
    public abstract static class ItemDecoration {

        //在item绘制之前调用绘制
        public void onDraw(@NonNull Canvas c, @NonNull RecyclerView parent, @NonNull State state) {
            onDraw(c, parent);
        }

        @Deprecated
        public void onDraw(@NonNull Canvas c, @NonNull RecyclerView parent) {
        }

        //在item绘制之后调用绘制
        public void onDrawOver(@NonNull Canvas c, @NonNull RecyclerView parent,
                @NonNull State state) {
            onDrawOver(c, parent);
        }

        @Deprecated
        public void onDrawOver(@NonNull Canvas c, @NonNull RecyclerView parent) {
        }

        @Deprecated
        public void getItemOffsets(@NonNull Rect outRect, int itemPosition,
                @NonNull RecyclerView parent) {
            outRect.set(0, 0, 0, 0);
        }

        //设置item偏移量
        public void getItemOffsets(@NonNull Rect outRect, @NonNull View view,
                @NonNull RecyclerView parent, @NonNull State state) {
            getItemOffsets(outRect, ((LayoutParams) view.getLayoutParams()).getViewLayoutPosition(),
                    parent);
        }
    }
  • 实现ItemDecoration自定义分割线
public class CustomDecoration extends RecyclerView.ItemDecoration {
    //分割线缩进值
    private int inset;
    private Paint paint;
    private int mOrientation;
    private Drawable mDivider;
    public static final int VERTICAL_LIST = LinearLayoutManager.VERTICAL;
    public static final int HORIZONTAL_LIST = LinearLayoutManager.HORIZONTAL;

    public CustomDecoration(Context context, int orientation, int inset) {
        this.inset = inset;
        paint = new Paint();
        paint.setAntiAlias(true);
        paint.setStyle(Paint.Style.FILL);
        paint.setColor(context.getResources().getColor(R.color.colorPrimary));
        setOrientation(orientation);
    }

    private void setOrientation(int orientation) {
        if (orientation != HORIZONTAL_LIST && orientation != VERTICAL_LIST) {
            throw new IllegalArgumentException("invalid orientation");
        }
        mOrientation = orientation;
    }

    public void setDrawable(Drawable drawable) {
        if (drawable == null) {
            throw new IllegalArgumentException("Drawable cannot be null.");
        }
        mDivider = drawable;
    }

    @Override
    public void onDraw(@NonNull Canvas c, @NonNull RecyclerView parent, @NonNull RecyclerView.State state) {
        if (parent.getLayoutManager() == null || mDivider == null) {
            return;
        }
        if (mOrientation == VERTICAL_LIST) {
            drawVertical(c, parent);
        } else {
            drawHorizontal(c, parent);
        }
    }

    private void drawVertical(Canvas canvas, RecyclerView parent) {
        final int left = parent.getPaddingLeft();
        final int right = parent.getWidth() - parent.getPaddingRight();
        final int childCount = parent.getChildCount();
        //最后一个item不画分割线
        for (int i = 0; i < childCount - 1; i++) {
            final View child = parent.getChildAt(i);
            final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child.getLayoutParams();
            final int top = child.getBottom() + params.bottomMargin;
            final int bottom = top + mDivider.getIntrinsicHeight();
            if (inset > 0) {
                canvas.drawRect(left, top, right, bottom, paint);
                mDivider.setBounds(left + inset, top, right - inset, bottom);
            } else {
                mDivider.setBounds(left, top, right, bottom);
            }
            mDivider.draw(canvas);
        }
    }

    private void drawHorizontal(Canvas canvas, RecyclerView parent) {
        final int top = parent.getPaddingTop();
        final int bottom = parent.getHeight() - parent.getPaddingBottom();
        final int childCount = parent.getChildCount();
        for (int i = 0; i < childCount - 1; i++) {
            final View child = parent.getChildAt(i);
            final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child.getLayoutParams();
            final int left = child.getRight() + params.rightMargin;
            final int right = left + mDivider.getIntrinsicHeight();
            mDivider.setBounds(left, top, right, bottom);
            mDivider.draw(canvas);
        }
    }

    @Override
    public void getItemOffsets(@NonNull Rect outRect, @NonNull View view, @NonNull RecyclerView parent, @NonNull RecyclerView.State state) {
        if (mDivider == null) {
            outRect.set(0, 0, 0, 0);
            return;
        }
        if (mOrientation == VERTICAL_LIST) {
            outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());
        } else {
            outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);
        }
    }
}
  • 在代码中使用
CustomDecoration d = new CustomDecoration(this, CustomDecoration.VERTICAL_LIST, 0);
d.setDrawable(R.drawable.decoration);
recyclerView.addItemDecoration(d);

五、增加下拉刷新、上拉加载更多

(1)SwipeRefreshLayout下拉刷新

  • 在xml文件中RecyclerView外部嵌套一个SwipeRefreshLayout
  • 在代码中实现SwipeRefreshLayout.OnRefreshListener接口
swipeRefreshLayout.setOnRefreshListener(new SwipeRefreshLayout.OnRefreshListener() {
    @Override
    public void onRefresh() {
        //开始刷新,设置刷新可见
        swipeRefreshLayout.setRefreshing(true);
        //向头部插入数据
        List<String> list = new ArrayList<String>();
        for (int i = 0; i < 5; i++) {
            int index = i + 1;
            list.add("new item" + index);
        }
        adapter.onItemAddList(list);
        //加载数据结束,设置刷新不可见
        swipeRefreshLayout.setRefreshing(false);
    }
});
  • 在adapter中添加onItemAddList方法
public void onItemAddList(List<String> list){
    list.addAll(this.list);
    this.list.clear();
    this.list.addAll(list);
    notifyDataSetChanged();
}

(2)上拉加载更多数据

  • RecyclerView实现OnScrollListener接口实现滑动监听
recyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrollStateChanged(@NonNull RecyclerView recyclerView, int newState) {
        super.onScrollStateChanged(recyclerView, newState);
        //停止滑动
        if (newState == RecyclerView.SCROLL_STATE_IDLE) {
            int lastItemPosition = layoutManager.findLastCompletelyVisibleItemPosition();
            int itemCount = layoutManager.getItemCount();
            //判断是否滑动到了最后一个item,并且是向上滑动
            if (lastItemPosition == (itemCount - 1) && isSlidingUpward) {
                List<String> list = new ArrayList<String>();
                for (int i = 0; i < 5; i++) {
                    int index = i + 1;
                    list.add("more item" + index);
                }
                adapter.onItemIncrease(list);
            }
        }
    }

    @Override
    public void onScrolled(@NonNull RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        //dy大于零表示正在向上滑动
        isSlidingUpward = dy > 0;
    }
});
  • 在adapter中添加刷新数据方法
public void onItemIncrease(List<String> list){
    this.list.addAll(list);
    notifyDataSetChanged();
}

相关文章

网友评论

      本文标题:RecyclerView详解

      本文链接:https://www.haomeiwen.com/subject/tlekzxtx.html