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开发详解》，转载请注明出处！！！