Android RecyclerView的基础实现

安卓实现RecyclerView全过程

自从Google更新AndroidX后,之前所有的android.support库都迁移到android.x上了。

现在项目也不再使用古老的Andorid support库了,查阅文档,了解到原com.android.support:recyclerview-v7已经迁移到androidx.recyclerview:recyclerview,直接上rc稳定版,即androidx.recyclerview:recyclerview:1.1.0-rc01

在Gradle闭包中加入:

1
2
3
4
5
dependencies {
...
implementation "androidx.recyclerview:recyclerview:1.1.0-rc01"
...
}

接着在activity_main中加入recyclerview:

1
2
3
4
5
6
7
8
9
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_height="match_parent"
android:layout_width="match_parent">
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/recycler_view"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</LinearLayout>

然后新建一个ListObject类,方便我们后面向链表中加入item

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

package com.droidye.droidreview;

public class ListObject {

private String name;

public ListObject(String name) {
this.name = name;
}

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}

}

为item定制样式:新建一个list_item.xml

1
2
3
4
5
6
7
8
9
10
11
12
13
14

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<TextView
android:id="@+id/name"
android:layout_width="wrap_content"
android:layout_height="60dp"
android:layout_gravity="center_vertical"
android:layout_marginLeft="10dp"
android:textSize="30sp"
/>
</LinearLayout>

准备工作完成,要开始写适配器了。

RecyclerView要正常运行需要以下几个条件:

1.必须指定一个适配器Adapter

2.必须指定一个布局管理器LayoutManager


创建适配器的一般流程:

① 创建Adapter:创建一个继承RecyclerView.Adapter的Adapter类(VH是ViewHolder的类名)

② 创建ViewHolder:在Adapter中创建一个继承RecyclerView.ViewHolder的静态内部类,记为VH。

③ 在Adapter中实现3个方法:

● onCreateViewHolder()

这个方法主要生成为每个Item inflater出一个View,返回值是一个ViewHolder。View会被封装在ViewHolder中。

● onBindViewHolder()

可以理解为将数据渲染到适配器中,在这个方法内进行setText等相关操作,点击事件也在此方法内完成。

● getItemCount()

顾名思义,统计item的数目

适配器完整代码实现如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

package com.droidye.droidreview;

import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
import android.widget.Toast;

import androidx.annotation.NonNull;
import androidx.recyclerview.widget.RecyclerView;
import java.util.List;

public class ListAdapter extends RecyclerView.Adapter<ListAdapter.ViewHolder> {
private List<ListObject> mList;

//ViewHolder配置 继承RecyclerView的ViewHolder
static class ViewHolder extends RecyclerView.ViewHolder{
TextView objName;

public ViewHolder(@NonNull View itemView) {
super(itemView);
objName = (TextView) itemView.findViewById(R.id.name);
}
}

//构造函数
public ListAdapter(List<ListObject> mList) {
this.mList = mList;
}


//为每个Item inflater出一个View,但是该方法返回的是一个ViewHolder
@NonNull
@Override
public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.list_item,parent,false);
ViewHolder vh = new ViewHolder(view);
return vh;
}

//适配渲染数据到View中
@Override
public void onBindViewHolder(@NonNull final ViewHolder holder, int position) {
final ListObject listObj = mList.get(position);
holder.objName.setText(listObj.getName());
holder.itemView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
Toast.makeText(view.getContext(),"你点击了" + listObj.getName(),Toast.LENGTH_SHORT).show();
}
});
}

//统计所有项
@Override
public int getItemCount() {
return mList.size();
}

}

写完适配器,要开始使用它了。

在MainActivity中设置。

前面提到两个必须:

1.必须指定一个适配器Adapter

2.必须指定一个布局管理器LayoutManager

代码如下,我已经标注出必选和可选:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

package com.droidye.droidreview;

import androidx.appcompat.app.AppCompatActivity;
import androidx.recyclerview.widget.DefaultItemAnimator;
import androidx.recyclerview.widget.LinearLayoutManager;
import androidx.recyclerview.widget.RecyclerView;

import android.os.Bundle;

import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {
private List<ListObject> listObj = new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//将item添加进去
initObjs();
RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
//设置布局管理器为线性布局管理器(必选)
recyclerView.setLayoutManager(new LinearLayoutManager(this));
//设置适配器(必选)
recyclerView.setAdapter(new ListAdapter(listObj));
//设置Item添加和删除的动画(可选)
recyclerView.setItemAnimator(new DefaultItemAnimator());
}

private void initObjs(){
for(int i = 0; i < 20; i ++){
ListObject listItem = new ListObject("Test");
listObj.add(listItem);
}
}
}

编写完这些代码,RecyclerView已经能够使用,在模拟器运行效果如下:

这就是RecyclerView的基础实现,RecyclerView的功能十分强大,后期我们还可以使用它完整ListView无法完成的横向布局以及瀑布布局,以及动态添加item等等…