Android 控件之 RecycleView

最新推荐文章于 2024-08-01 21:34:34 发布

置顶云儿cloudy

最新推荐文章于 2024-08-01 21:34:34 发布

阅读量504

点赞数

分类专栏： Android

Android 专栏收录该内容

15 篇文章 0 订阅

订阅专栏

文章目录

什么是RecycleView

从Android 5.0开始，谷歌公司推出了一个用于大量数据展示的新控件RecylerView，可以用来代替传统的ListView，更加强大和灵活。RecyclerView的官方定义如下：

A flexible view for providing a limited window into a large data set.

从定义可以看出，flexible（可扩展性）是RecyclerView的特点。

RecyclerView是support-v7包中的新组件，是一个强大的滑动组件，与经典的ListView相比，同样拥有item回收复用的功能，这一点从它的名字Recyclerview即回收view也可以看出。

RecycleView的优点

从Android 5.0开始，谷歌公司推出了一个用于大量数据展示的新控件RecylerView，可以用来代替传统的ListView，更加强大和灵活。RecyclerView的官方定义如下：

A flexible view for providing a limited window into a large data set.

从定义可以看出，flexible（可扩展性）是RecyclerView的特点。

RecylerView相对于ListView的优点罗列如下：

RecyclerView封装了viewholder的回收复用，也就是说RecyclerView标准化了ViewHolder，编写Adapter面向的是ViewHolder而不再是View了，复用的逻辑被封装了，写起来更加简单。
直接省去了listview中convertView.setTag(holder)和convertView.getTag()这些繁琐的步骤。
提供了一种插拔式的体验，高度的解耦，异常的灵活，针对一个Item的显示RecyclerView专门抽取出了相应的类，来控制Item的显示，使其的扩展性非常强。
设置布局管理器以控制Item的布局方式，横向、竖向以及瀑布流方式
例如：你想控制横向或者纵向滑动列表效果可以通过LinearLayoutManager这个类来进行控制(与GridView效果对应的是GridLayoutManager,与瀑布流对应的还StaggeredGridLayoutManager等)。也就是说RecyclerView不再拘泥于ListView的线性展示方式，它也可以实现GridView的效果等多种效果。
可设置Item的间隔样式（可绘制）
通过继承RecyclerView的ItemDecoration这个类，然后针对自己的业务需求去书写代码。
可以控制Item增删的动画，可以通过ItemAnimator这个类进行控制，当然针对增删的动画，RecyclerView有其自己默认的实现。

但是关于Item的点击和长按事件，需要用户自己去实现。

常见的几种使用

recyclerView = (RecyclerView) findViewById(R.id.recyclerView);  
LinearLayoutManager layoutManager = new LinearLayoutManager(this );  
//设置布局管理器  
recyclerView.setLayoutManager(layoutManager);  
//设置为垂直布局，这也是默认的  
layoutManager.setOrientation(OrientationHelper. VERTICAL);  
//设置Adapter  
recyclerView.setAdapter(recycleAdapter);  
//设置分隔线  
recyclerView.addItemDecoration( new DividerGridItemDecoration(this ));  
//设置增加或删除条目的动画  
recyclerView.setItemAnimator( new DefaultItemAnimator());

在使用RecyclerView时候，必须指定一个适配器Adapter和一个布局管理器LayoutManager。适配器继承RecyclerView.Adapter类，具体实现类似ListView的适配器，取决于数据信息以及展示的UI。布局管理器用于确定RecyclerView中Item的展示方式以及决定何时复用已经不可见的Item，避免重复创建以及执行高成本的findViewById()方法。

可以看见RecyclerView相比ListView会多出许多操作，这也是RecyclerView灵活的地方，它将许多动能暴露出来，用户可以选择性的自定义属性以满足需求。

基本使用

RecyclerView的四大“组件”：

Adapter：为Item提供数据。
Layout Manager：Item的布局。
Item Animator：添加、删除Item动画。
Item Decoration：Item之间的Divider。

配置 build.gradle

想要使用RecycleView，我们首先要导入support-v7包，再sync下代码

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:27.1.1'
    implementation 'com.android.support:recyclerview-v7:27.1.1'
	. . .
}

使用RecycleView

RecyclerView mRecyclerView=findViewById(R.id.recycler_view);
		//设置显示布局
		mRecyclerView.setLayoutManager(new LinearLayoutManager(this));
		//设置删除与加入的动画
        mRecyclerView.setItemAnimator(new DefaultItemAnimator());
        final HomeAdapter mHomeAdapter = new HomeAdapter(this, mList);
     	mRecyclerView.setAdapter(mHomeAdapter);

与ListView不同的一点，RecycleView需要在设置布局管理器用于设置条目的排列样式，可以是垂直排列或者水平排列。这里我们设置mRecyclerView.setLayoutManager(new LinearLayoutManager(this))表示条目是线性排列的（默认是垂直排列的）如果想要设置为水平排列，可以按如下代码所示编写：

 LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);
       linearLayoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);
       mRecyclerView.setLayoutManager(linearLayoutManager);

此外，RecycleView比ListView的设置要复杂一些，主要是它需要自己去定义分割线，设置动画和布局管理器等。布局文件内容如下：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <android.support.v7.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content">
    </android.support.v7.widget.RecyclerView>
</RelativeLayout>

Adapter最大的改进就是对ViewHolder进行了封装定义，我们只需要自定义一个ViewHolder继承RecycleView.ViewHolder就可以了。另外，Adapter继承了Recycle.Adapter，在onCreateViewHolder中加载条目布局，在onBindViewHolder中将视图与数据进行绑定。

/**
 * @author by created chen cloudy 2018/10/22 16:22
 **/

public class HomeAdapter extends RecyclerView.Adapter<HomeAdapter.MyViewHolder>{
private OnItemClickListener mOnItemClickListener;
    public interface OnItemClickListener {
        /**
         * 单击的点击事件
         * @param view 画层
         * @param position 点击的条目
         */
        void onItemClick(View view, int position);

        /**
         * 长按的点击事件
         * @param view 画层
         * @param position 点击的条目
         */
        void onItemLongClick(View view,int position);
    }
    public void setOnItemClickListener(OnItemClickListener mOnItemClickListener){
        this.mOnItemClickListener=mOnItemClickListener;
    }
    private List<String> mList;
    private Context mContext;
    public HomeAdapter(Context mContext,List<String> mList){
        this.mContext=mContext;
        this.mList=mList;
    }
    public void removeData(int position){
        mList.remove(position);
        notifyItemRemoved(position);
    }
    @NonNull
    @Override
    public HomeAdapter.MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        HomeAdapter.MyViewHolder holder =new HomeAdapter.MyViewHolder(
                LayoutInflater.from(mContext).inflate(R.layout.item_recycler,parent,false));
        return holder;
    }
    @Override
    public void onBindViewHolder(@NonNull final HomeAdapter.MyViewHolder holder, int position) {
        holder.tv.setText(mList.get(position));
        if(mOnItemClickListener!=null){
            holder.tv.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    int pos= holder.getLayoutPosition();
                    mOnItemClickListener.onItemClick(holder.tv,pos);
                }
            });
            holder.tv.setOnLongClickListener(new View.OnLongClickListener() {
                @Override
                public boolean onLongClick(View v) {
                    int pos=holder.getLayoutPosition();
                    mOnItemClickListener.onItemLongClick(holder.tv,pos);
                    return false;
                }
            });
        }
    }
    @Override
    public int getItemCount() {
        return mList.size();
    }
    class MyViewHolder extends RecyclerView.ViewHolder{
        TextView tv;
        public MyViewHolder(View view){
            super(view);
            tv=view.findViewById(R.id.tv_item);
        }
    }
}

在HomeAdapter的onCreateViewHolder方法中我们加载了条目的样式文件item_recycle，他的布局与ListView一样，可以简单成一行，也可以定义多个属性。

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    tools:context=".MainActivity">
<TextView
    android:id="@+id/tv_item"
    android:gravity="center"
    android:textSize="50dp"
    android:background="@color/colorPrimaryDark"
    android:textColor="@color/colorAccent"
    android:layout_width="wrap_content"
    android:layout_height="match_parent">
</TextView>
</FrameLayout>

设置分割线

我们使用mRecycleView.addItemDecoration()来加入分割线。默认是没有分割线，这样我们就需要继承RecycleView.ItemDecoration来自定义分割线。

package com.example.chenduoyun.recycleview;

import android.content.Context;
import android.content.res.TypedArray;
import android.graphics.Canvas;
import android.graphics.Rect;
import android.graphics.drawable.Drawable;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.util.Log;
import android.view.View;

import static android.content.ContentValues.TAG;

/**
 * @author by created chen cloudy 2018/10/22 14:04
 **/

public class DividerItemDecoration extends RecyclerView.ItemDecoration {
    private static final int[] ATTRS = new int[]{
            android.R.attr.listDivider
    };
    public static final int HORIZONTAL_LIST = LinearLayoutManager.HORIZONTAL;
    public static final int VERTICAL_LIST = LinearLayoutManager.VERTICAL;
    private Drawable mDivider;
    private int mOrientation;

    public DividerItemDecoration(Context context, int orientation) {
        final TypedArray a = context.obtainStyledAttributes(ATTRS);
        mDivider = a.getDrawable(0);
        a.recycle();
        setOrientation(orientation);
    }

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

    @Override
    public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
        if(mOrientation==VERTICAL_LIST){
            drawVertical(c,parent);
            Log.d(TAG, "onDraw: cdy VERTICAL_LIST"+VERTICAL_LIST);
        }else{
            drawHorizontal(c,parent);
            Log.d(TAG, "onDraw: cdy HORIZONTAL_LIST"+HORIZONTAL_LIST);
        }
    }

    private void drawVertical(Canvas c, RecyclerView parent) {
        final int left =parent.getPaddingLeft();
        final int right = parent.getWidth()-parent.getPaddingRight();
        final int childCount = parent.getChildCount();
        for (int i = 0; i < childCount; i++) {
            Log.d(TAG, "drawVertical: cdy"+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();
            mDivider.setBounds(left,top,right,bottom);
            mDivider.draw(c);
        }
    }

    private void drawHorizontal(Canvas c, 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; 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.getIntrinsicWidth();
            mDivider.setBounds(left,top,right,bottom);
            mDivider.draw(c);
        }

    }

    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        if(mOrientation==VERTICAL_LIST){
            outRect.set(0,0,0,mDivider.getIntrinsicHeight());
        }else {
            outRect.set(0,0,mDivider.getIntrinsicWidth(),0);
        }
    }
}

这里核心的方法就是onDraw方法，它根据传进来的orientation来判断是绘制横向item的分割线还是纵向的分割线。其中，drawHorizontal用于绘制，drawVertical 。getItemOffsets方法则用于设置item的padding属性。虽然没有默认的分割线，但是使用DividerItemDecoration 方法可以更加灵活地去自定义分割线，实现自定义分割线的功能。只需要在setAdapter之前加入如下代码便可加入分割线

 mRecyclerView.addItemDecoration(new DividerItemDecoration(this,DividerItemDecoration.HORIZONTAL_LIST));

添加点击事件

在Adapter中定义接口并提供回调，在这里我们定义了条目的点击事件与长按事件。

private OnItemClickListener mOnItemClickListener;
    public interface OnItemClickListener {
        /**
         * 单击的点击事件
         * @param view 画层
         * @param position 点击的条目
         */
        void onItemClick(View view, int position);

        /**
         * 长按的点击事件
         * @param view 画层
         * @param position 点击的条目
         */
        void onItemLongClick(View view,int position);
    }
    public void setOnItemClickListener(OnItemClickListener mOnItemClickListener){
        this.mOnItemClickListener=mOnItemClickListener;
    }

接下来对item中的控件进行点击事件监听并回调给自定义的监听，如下所示：

@Override
    public void onBindViewHolder(@NonNull final HomeAdapter.MyViewHolder holder, int position) {
        holder.tv.setText(mList.get(position));
        if(mOnItemClickListener!=null){
            holder.tv.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    int pos= holder.getLayoutPosition();
                    mOnItemClickListener.onItemClick(holder.tv,pos);
                }
            });
            holder.tv.setOnLongClickListener(new View.OnLongClickListener() {
                @Override
                public boolean onLongClick(View v) {
                    int pos=holder.getLayoutPosition();
                    mOnItemClickListener.onItemLongClick(holder.tv,pos);
                    return false;
                }
            });
        }
    }

最后在Activity中进行监听：

  mHomeAdapter.setOnItemClickListener(new HomeAdapter.OnItemClickListener() {
            @Override
            public void onItemClick(View view, int position) {
                Toast.makeText(getApplicationContext(),"点击了第"+(position+1)+"条",Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onItemLongClick(View view, final int position) {
                //这里的context必须写成MainActivity.this，不能写成getApplicationContext()
                new AlertDialog.Builder(MainActivity.this)
                        .setTitle("确定删除吗？")
                        .setNegativeButton("取消",null)
                        .setPositiveButton("确定", new DialogInterface.OnClickListener() {
                            @Override
                            public void onClick(DialogInterface dialog, int which) {
                                mHomeAdapter.removeData(position);
                            }
                        }).show();
            }
        });

实现GridView

只需要自定义横向的分割线，然后在代码中设置：

	mRecyclerView.setLayoutManager(new StaggeredGridLayoutManager(4,StaggeredGridLayoutManager.VERTICAL));
    mRecyclerView.addItemDecoration(new DividerItemDecoration(this,0));

DividerItemDecoration(context,orientation),当orientation=0时，表示竖向分割；当orientation=1时，表示横向分割（有分割线的形式）

实现瀑布流

为了实现方便方便，这里不使用mRecyclerView.addItemDecoration(new DividerItemDecoration(this,DividerItemDecoration.VERTICAL_LIST))方法来实现分割线，可以在item布局文件中定义分割距离,添加layout_margin属性。

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:layout_margin="2dp"
    tools:context=".MainActivity">

<TextView
    android:id="@+id/tv_item"
    android:gravity="center"
    android:textSize="50dp"
    android:background="@color/colorPrimaryDark"
    android:textColor="@color/colorAccent"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">
</TextView>

</FrameLayout>

实现瀑布流只要在Adapter写下一个随机高度来控制每个item的高度就可以了。一般是通过网络数据控制，这里写上一个随机函数来控制每个item高度，然后在Adapter的onBindViewHolder中添加每一个item的高度：

 ViewGroup.LayoutParams lp=holder.tv.getLayoutParams();
        lp.height = (int)(200+Math.random()*500);
        holder.tv.setLayoutParams(lp);

云儿cloudy

关注

0
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
复制链接

分享到 QQ

分享到新浪微博

扫一扫

专栏目录