RecyclerView的基础用法

为了让RecyclerView可以在所有的Android版本中都能使用，Android开发团队将RecyclerView定义在support.v7包当中。在使用该控件时需要打开当前Modile的build.gradle文件,然后在dependencies节点中添加依赖库的代码。具体代码如下：

compile 'com.android.support:recyclerview-v7:插入版本号'

添加完成以后需要单击右上角的Sync Now进行同步。同步完成后可以在布局文件中添加RecyclerView控件，语法格式如下：

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

控制RecyclerView需要一些常用的方法，具体方法如下：

◆ setLayoutManager:设置列表项的布局管理器，LinearLayoutManager为线性布局管理器、GridLayoutManager为网格布局管理器、StaggeredGridLayoutManager为瀑布流网格布局管理器。

◆ setItemAnimator：设置列表项增加或者是删除时的动画，可以使用关键字new创建 DefaultItemAnimator()对象实现系统默认的动画效果。

◆ addItemDecoration：添加列表项分割线。

◆ addOnItemTouchListener：添加列表项的触摸监听器。

◆ removeOnItemTouchListener：移除列表项的触摸监听器。

◆ setAdapter：设置列表项的适配器，使用RecyclerView.Adapter。

RecyclerView.Adapter是为RecyclerView所单独设计的适配器类，RecyclerView.Adapter的相关方法如下：

◆ getItemCount:获取列表项的数目。

◆ onBindViewHolder：绑定列表项中所显示的数据。

◆ onCreateViewHolder:在该方法中可以加载列表item（子项）中的布局文件。

下面通过一个具体的实例演示RecyclerView垂直列表的具体应用。

实例 模拟QQ消息列表

在Android Studio中创建Module，名称为“QQMessageList”，具体步骤如下：

（1）打开build.gradle（Module: QQMessageList）文件，然后在该文件中的dependencies节点中添加依赖库的代码。

（2）修改新建Module的res/layout目录下的布局文件activity_main.xml，将默认添加的布局管理器修改为相对布局管理器并将TextView组件删除，然后添加1个RecyclerView组件用于显示消息列表。具体代码如下：

01   <?xml version="1.0" encoding="utf-8"?>
 
02   <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
 
03       xmlns:app="http://schemas.android.com/apk/res-auto"
 
04       xmlns:tools="http://schemas.android.com/tools"
 
05       android:layout_width="match_parent"
 
06       android:layout_height="match_parent"
 
07       tools:context="com.mingrisoft.MainActivity">
 
08       <!--列表控件-->
 
09       <android.support.v7.widget.RecyclerView
 
10           android:id="@+id/recyclerview"
 
11           android:background="#EEEEEE"
 
12           android:layout_width="match_parent"
 
13           android:layout_height="wrap_content"
 
14           android:orientation="vertical"
 
15           />
 
16   </RelativeLayout>

（3）在res/layout目录中创建1个名称为layout_item.xml的布局文件，将默认添加的布局管理器修改为相对布局管理器，首先添加1个ImageView组件用于显示头像的图标，然后添加1个垂直线性布局管理器，在该布局管理器中添加2个TextView组件分别用于显示名称与文字消息。具体代码如下：

01   <?xml version="1.0" encoding="utf-8"?>
 
02   <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
 
03       android:layout_width="match_parent"
 
04       android:layout_height="50dp"
 
05       android:layout_marginBottom="1dp"
 
06       android:background="@android:color/white"
 
07       android:gravity="center_vertical">
 
08       <!--图标-->
 
09       <ImageView
 
10           android:id="@+id/img"
 
11           android:layout_width="50dp"
 
12           android:layout_height="50dp"
 
13           android:layout_alignParentLeft="true"
 
14           android:layout_alignParentStart="true"
 
15           android:layout_alignParentTop="true" />
 
16       <LinearLayout
 
17           android:layout_width="wrap_content"
 
18           android:layout_height="match_parent"
 
19           android:layout_toRightOf="@+id/img"
 
20           android:gravity="center_vertical"
 
21           android:orientation="vertical">
 
22           <!--名称-->
 
23           <TextView
 
24               android:id="@+id/name"
 
25               android:layout_width="match_parent"
 
26               android:layout_height="wrap_content"
 
27               android:layout_marginLeft="20dp"
 
28               android:textColor="#000000"
 
29               android:textSize="15dp" />
 
30           <!--消息-->
 
31           <TextView
 
32               android:id="@+id/info"
 
33               android:layout_width="match_parent"
 
34               android:layout_height="wrap_content"
 
35               android:layout_marginLeft="20dp"
 
36               android:layout_marginRight="15dp"
 
37               android:singleLine="true"
 
38               android:textSize="10dp" />
 
39       </LinearLayout>
 
40   </RelativeLayout>

（4）在res/values目录中的strings.xml字符串资源文件内添加名字与文字消息，用于显示在列表当中。

（5）在com.mingrisoft包中创建1个名称为Adapter的Java类，首先在该类中创建1个名称为MyViewHolder的内部类并让该类继承自RecyclerView.ViewHolder，在该内部类中获取列表中用于显示名称、头像图标与文字信息的组件。然后让Adapter类继承自RecyclerView.Adapter<Adapter.MyViewHolder>并且实现相对应的方法。具体代码如下：

01   public class Adapter extends RecyclerView.Adapter<Adapter.MyViewHolder> {
 
02       @Override
 
03       public MyViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
 
04           return null;
 
05       }
 
06       @Override
 
07       public void onBindViewHolder(MyViewHolder holder, int position) {
 
08       }
 
09       @Override
 
10       public int getItemCount() {
 
11           return 0;
 
12       }
 
13       class MyViewHolder extends RecyclerView.ViewHolder {
 
14           public TextView name, info;              //编号文字
 
15           public ImageView img;                     //图标
 
16    
 
17           //获取相关控件
 
18           public MyViewHolder(View itemView) {
 
19               super(itemView);
 
20               name = (TextView) itemView.findViewById(R.id.name);
 
21               info = (TextView) itemView.findViewById(R.id.info);
 
22               img = (ImageView) itemView.findViewById(R.id.img);
 
23           }
 
24       }
 
25   }

（6）创建3个int类型的数组分别用于保存头像的图标资源、名字、文字信息，然后创建3个ArrayList集合分别用于保存数组中的资源文件，最后创建1个Adapter构造方法，在该方法中设置菜单行数与行内图标、名称与文字信息具体代码如下：

01   //图标数组
 
02   private int[] icons = {
 
03           R.mipmap.icon_1, R.mipmap.icon_2, R.mipmap.icon_3,
 
04           R.mipmap.icon_4, R.mipmap.icon_5, R.mipmap.icon_6,
 
05           R.mipmap.icon_7, R.mipmap.icon_8, R.mipmap.icon_9,
 
06           R.mipmap.icon_10, R.mipmap.icon_11
 
07   };
 
08   //名字数组，引用资源文件中的文字
 
09   private int[] names = {
 
10           R.string.name1, R.string.name2, R.string.name3,
 
11           R.string.name4, R.string.name5, R.string.name6,
 
12           R.string.name7, R.string.name8, R.string.name9,
 
13           R.string.name10, R.string.name11
 
14   };
 
15   //信息数组
 
16   private int[] infos = {
 
17           R.string.info1, R.string.info2, R.string.info3,
 
18           R.string.info4, R.string.info5, R.string.info6,
 
19           R.string.info7, R.string.info8, R.string.info9,
 
20           R.string.info10, R.string.info11
 
21   };
 
22   private Context lContext;   //上下文
 
23   private List<Integer> listIcon = new ArrayList<Integer>();   //图标集合
 
24   private List<Integer> listName = new ArrayList<Integer>();   //名称集合
 
25   private List<Integer> listInfo = new ArrayList<Integer>();   //信息集合
 
26   public Adapter(Context context) {
 
27       lContext = context;
 
28       //设置菜单行数与行内图标、名称、信息
 
29       for (int i = 0; i < 11; i++) {
 
30           listIcon.add(icons[i]);
 
31           listName.add(names[i]);
 
32           listInfo.add(infos[i]);
 
33       }
 
34   }

（7）重写MyViewHolder onCreateViewHolder()方法，在该方法中实现获取列表中，每行item的布局文件。修改后代码如下：

01   @Override
 
02   public MyViewHolder onCreateViewHolder(ViewGroup arg0, int arg1) {
 
03       //获取列表中，每行的布局文件
 
04       View view = LayoutInflater.from(lContext).inflate(R.layout.layout_item, arg0, false);
 
05       MyViewHolder holder = new MyViewHolder(view);           //
 
06       return holder;
 
07   }

（8）重写onBindViewHolder()方法，在该方法中设置列表菜单中item（子项）所显示的内容。修改后代码如下：

01   @Override
 
02   public void onBindViewHolder(final MyViewHolder holder, int position) {
 
03       //设置图标
 
04       holder.img.setBackgroundResource(listIcon.get(position));
 
05       //设置名称
 
06       holder.name.setText(listName.get(position));
 
07       //设置信息
 
08       holder.info.setText(listInfo.get(position));
 
09   }

（9）重写getItemCount()方法，在该方法中实现返回数据集中的项目总数。修改后代码如下：

01   @Override
 
02   public int getItemCount() {
 
03       return listIcon.size();
 
04   }

（10）打开主活动MainActivity.java文件，定义所需要的全局变量，在onCreate()方法中首先获取RecyclerView组件，然后为其设置列表布局管理器，最后为其设置适配器。具体代码如下：

01   public class MainActivity extends AppCompatActivity {
 
02       private RecyclerView lRecyclerView;     //列表控件
 
03       private Adapter lAdapter;                //适配器
 
04       @Override
 
05       protected void onCreate(Bundle savedInstanceState) {
 
06           super.onCreate(savedInstanceState);
 
07           setContentView(R.layout.activity_main);
 
08           //获取列表控件
 
09           lRecyclerView = (RecyclerView) findViewById(R.id.recyclerview);
 
10           //设置列表布局管理
 
11           lRecyclerView.setLayoutManager(new LinearLayoutManager(this));
 
12           //设置适配器
 
13           lRecyclerView.setAdapter(lAdapter = new Adapter(this));
 
14       }
 
15   }

（10）在工具栏中，找到下拉列表框，然后单击要运行的应用（这里为QQMessageList），再单击右侧的运行按钮，运行效果如图27.27所示。

图27.27  模拟QQ消息列表

本文来自明日科技即将出版的《Android开发详解》，转载请注明出处！！！