1.概述
RecyclerView是從Android 5.0開(kāi)始谷歌推出一個(gè)用于展示大量數(shù)據(jù)的新控件,用以替換傳統(tǒng)的ListView控件颗管。它具有高度的解耦蔫慧、異常的靈活性和更高的效率玫锋,通過(guò)設(shè)置它提供的不同的LayoutManager蛾茉、ItemDecoration、ItemAnimator可以實(shí)現(xiàn)豐富多彩的效果撩鹿。
2.使用方法
2.1 添加依賴(lài)
PS:Android28之后谷歌不再推薦使用v7包谦炬,故使用如下新的導(dǎo)入方式
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'androidx.appcompat:appcompat:1.1.0'
implementation group: 'androidx.recyclerview', name: 'recyclerview', version: '1.1.0'
}
2.2 新建布局文件
1.此處布局文件(recycler_view_list.xml)為提供給RecyclerView中每個(gè)item使用的樣式文件。例子比較簡(jiǎn)單,只在布局文件中添加了一個(gè)TextView键思,想要炫酷的效果可自行設(shè)計(jì)础爬。
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<TextView
android:id="@+id/list_item"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:gravity="center"/>
</RelativeLayout>
2.在要使用RecyclerView的布局文件中添加RecyclerView控件
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/layout_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/my_recycler_view"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</RelativeLayout>
2.3 新建ViewHolder類(lèi)繼承RecyclerView.ViewHolder
public class MyViewHolder extends RecyclerView.ViewHolder {
TextView textView;
MyViewHolder(@NonNull View itemView) {
super(itemView);
textView = itemView.findViewById(R.id.list_item);
}
}
2.4 新建Adapter類(lèi)繼承RecyclerView.Adapter
public class MyAdapter extends RecyclerView.Adapter {
private Context context;
private MyViewHolder viewHolder;
private ArrayList<String> list;
public MyAdapter(Context context, ArrayList<String> list) {
this.context = context;
this.list = list;
}
@NonNull
@Override
public RecyclerView.ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
// 此處建議inflate方法傳兩個(gè)參數(shù),即第二個(gè)參數(shù)傳null
// 如果使用三個(gè)參數(shù)的inflate方法(即第二個(gè)參數(shù)傳parent)的情況下吼鳞,recycler_view_list布局文件的layout_width和layout_height方法一般不能同時(shí)為match_parent
// 因?yàn)檫@樣會(huì)使單個(gè)item占滿(mǎn)整個(gè)RecyclerView看蚜,導(dǎo)致只能顯示一個(gè)item,需要滑動(dòng)才能顯示其他item
viewHolder = new MyViewHolder(LayoutInflater.from(context).inflate(R.layout.recycler_view_list, parent, false));
return viewHolder;
}
@Override
public void onBindViewHolder(@NonNull RecyclerView.ViewHolder holder, int position) {
// 在onBindViewHolder方法中無(wú)法使用子類(lèi)ViewHolder對(duì)象作為參數(shù)
System.out.println("MyAdapter position:" + position);
viewHolder.textView.setText(list.get(position));
}
@Override
public int getItemCount() {
// 此方法一定要重寫(xiě)赔桌,否則recyclerView不顯示供炎,通常是返回list.size()
// onBindViewHolder中的position從此方法的返回值中取得
System.out.println("MyAdapter list.size():" + list.size());
return list.size();
}
}
2.5 在項(xiàng)目中使用
public class MainActivity extends AppCompatActivity {
private RecyclerView recyclerView;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ArrayList<String> list = new ArrayList<>();
for (int i = 0; i < 10; i++) {
list.add(String.valueOf(i));
}
RecyclerView.LayoutManager layoutManager = new LinearLayoutManager(this);
MyAdapter adapter = new MyAdapter(this, list);
recyclerView = findViewById(R.id.my_recycler_view);
recyclerView.setLayoutManager(layoutManager);
recyclerView.setAdapter(adapter);
}
}
3.實(shí)現(xiàn)效果
4.總結(jié)
4.1 使用方法總結(jié)
雖然有adapter的存在讓使用顯得略微復(fù)雜了一些,但是抽象起來(lái)看整個(gè)過(guò)程就是往adapter里填充viewHolder疾党,再往recyclerView中填充adapter而已碱茁。
4.2 踩坑總結(jié)
1.getItemCount()方法一定要重寫(xiě)!7卤帷!
此方法不重寫(xiě)則RecyclerView完全無(wú)法展示墓贿,且onCreateViewHolder和onBindViewHolder方法完全不會(huì)被調(diào)用茧泪。
2.recyclerView使用時(shí)一定要調(diào)用setLayoutManager()及setAdapter()方法
3.在重寫(xiě)的onCreateViewHolder方法中,調(diào)用inflate方法往viewHolder中填充布局時(shí)聋袋,要注意布局文件的layout_width和layout_height屬性值(詳情見(jiàn)代碼注釋?zhuān)┒游啊R驗(yàn)锳S新建的布局文件默認(rèn)值都是match_parent,搞得我找了好久才找到原因S睦铡J任辍!
4.RecyclerView只提供了DividerItemDecoration作為默認(rèn)的分割線(xiàn)啥容,復(fù)雜效果需要手動(dòng)繼承RecyclerView.ItemDecoration來(lái)自定義分割線(xiàn)锈颗,同時(shí)列表中各個(gè)條目的點(diǎn)擊事件也需要自定義實(shí)現(xiàn)。
5.后記
這是個(gè)人的第一篇博客咪惠,開(kāi)博客的目的也只是為了強(qiáng)化自己對(duì)于知識(shí)點(diǎn)的理解和記憶击吱,并在以后遇到類(lèi)似問(wèn)題的時(shí)候能及時(shí)找到解決辦法。本人對(duì)安卓的理解和掌握也還不深刻遥昧,希望大家理解覆醇。
多的不說(shuō)了,控制自己炭臭,掌控?cái)橙擞琅В佑停。鞋仍。?/p>