简单的recyclerView
1.AndroidStudio3.4中引入recyclerview的依赖
dependencies {
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation 'androidx.appcompat:appcompat:1.0.2'
implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
implementation 'androidx.recyclerview:recyclerview:1.0.0-alpha1'
testImplementation 'junit:junit:4.12'
androidTestImplementation 'androidx.test:runner:1.2.0'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
}
添加完记得点击一下Sync Now来进行同步。
2.修改activity_main.xml中的代码
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="horizontal">
<androidx.recyclerview.widget.RecyclerView
android:id="@+id/recycler_view"
android:layout_width="match_parent"
android:layout_height="match_parent">
</androidx.recyclerview.widget.RecyclerView>
</LinearLayout>
将宽度和高度都设置为match_parent,这样recyclerview就沾满整个布局了。因为Recyclerview没有内置在sdk中,所以要把完整的包路径写出来。
3.新建实体类,这里以Fruit类为例。
public class Fruit {
private String name;
private int imageId;
public Fruit(String name, int imageId){
this.name = name;
this.imageId = imageId;
}
public int getImageId() {
return imageId;
}
public void setImageId(int imageId) {
this.imageId = imageId;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
4.新建fruit_item.xml文件,作为RecyclerView中每一条数据的布局文件。可以任意布局,这里以一张图片和一个textview为例。
<LinearLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<ImageView
android:id="@+id/fruit_image"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:contentDescription="水果图片" />
<TextView
android:id="@+id/fruit_name"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_gravity="center_vertical"
android:layout_marginLeft="10dp"
android:text="水果名"/>
</LinearLayout>
5.自定义Adapter。
新建FruitAdapter,继承自RecyclerView.Adapter,并将泛型指定为FruitAdapter.ViewHolder。其中,ViewHolder是我们在FruitAdapter中定义的内部类。
public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> {
private List<Fruit> myFruitList;
public FruitAdapter(List<Fruit> fruitList){
myFruitList = fruitList;
}
static class ViewHolder extends RecyclerView.ViewHolder{
ImageView fruitImage;
TextView fruitName;
public ViewHolder(View view){
super(view);
fruitImage = view.findViewById(R.id.fruit_image);
fruitName = view.findViewById(R.id.fruit_name);
}
}
/**
* 用于创建ViewHolder实例
* 将子布局加载进来,创建ViewHolder实例,将子布局传进去,
* @param parent
* @param viewType
* @return
*/
@NonNull
@Override
public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item,parent,false);
final ViewHolder viewHolder = new ViewHolder(view);
return viewHolder;
}
/**
* 对子项赋值
* 在每个子项被滚动到屏幕内时执行
* @param holder
* @param position
*/
@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
Fruit fruit = myFruitList.get(position);
holder.fruitImage.setImageResource(fruit.getImageId());
holder.fruitName.setText(fruit.getName());
}
@Override
public int getItemCount() {
return myFruitList.size();
}
}
解释一下,首先定义了一个内部类ViewHolder,继承自RecyclerView.ViewHolder。然后写一下ViewHolder的构造函数,传入一个View参数,这个View参数通常是RecyclerView子项的最外层布局,就是我们这里所说的fruit_item.xml布局。
接下来写FruitAdapter的构造函数,这个方法用于把要展示的数据源传进来,并赋值给一个全局变量myFruitList,后续操作都在这个数据源的基础上进行。
最后,重写onCreateViewHolder()、onBindViewHolder()和getItem()这三个方法。
onCreateViewHolder()方法:
用于创建ViewHolder的实例。
LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item,parent,false);
用这句话获取RecyclerView中的子布局。
调用ViewHolder的构造方法,将刚得到的这个子布局view传入,并返回构造出来的ViewHolder实例。
onBindViewHolder()方法:
用于对RecyclerView的子项数据进行赋值,在每个子项被滚动到屏幕内时执行。
首先通过position参数得到当前项的fruit实例,然后将数据设置到ViewHolder的ImageView和TextView中。
getItemCount():
用于告诉RecyclerView一共有多少子项。
直接返回数据源(即这里的myFruitList)的长度即可。
6.开始使用RecyclerView。
修改MainActivity中的代码:
public class MainActivity extends AppCompatActivity {
private List<Fruit> fruitList = new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initFruits();
RecyclerView recyclerView = findViewById(R.id.recycler_view);
LinearLayoutManager linearLayoutManager = new LinearLayoutManager(this);
recyclerView.setLayoutManager(linearLayoutManager);
FruitAdapter fruitAdapter = new FruitAdapter(fruitList);
recyclerView.setAdapter(fruitAdapter);
}
private void initFruits(){
//三层循环是为了让数据充满屏幕,可方便看到屏幕滚动查看数据的效果,由于没有去找图片,这里就放了android自带的图片
for(int i=0;i<3;i++){
Fruit apple = new Fruit("apple", R.drawable.ic_launcher_background);
fruitList.add(apple);
Fruit banana = new Fruit("banana", R.drawable.ic_launcher_background);
fruitList.add(banana);
Fruit grape = new Fruit("grape", R.drawable.ic_launcher_background);
fruitList.add(grape);
}
}
}
解释一下:
initFruits()方法用于初始化数据。
首先实例化一个LinearLayoutManager,
并将这个LinearLayoutManager设置给recyclerView。
然后通过FruitAdapter的构造方法将数据传给FruitAdapter的实例。
最后将fruitAdapter设置给recyclerView。
这样RecyclerView与数据之间的关联就建立完成了。
这里的LinearLayoutManager是线性布局的意思,可以实现和ListView类似的效果。
7.为RecyclerView添加点击事件。
RecyclerView并没有提供类似于ListView中类似setOnItemClickListener()这样的注册监听器方法。而需要我们自己给子项具体的view注册点击事件。
注:说一下RecyclerView这样做的目的。ListView中的setOnItemClickListener()注册的是子项的点击事件,但是如果我想点击的是子项里具体的某一个按钮,实现起来就比较麻烦了。而RecyclerView将所有的点击事件都交给具体的View去注册,实现起来就简单多了。
修改FruitAdaper中的代码,急于实现效果的小伙伴可直接将这段复制覆盖掉上面的FruitAdaper的代码。
public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> {
private List<Fruit> myFruitList;
public FruitAdapter(List<Fruit> fruitList){
myFruitList = fruitList;
}
static class ViewHolder extends RecyclerView.ViewHolder{
View fruitView;
ImageView fruitImage;
TextView fruitName;
public ViewHolder(View view){
super(view);
fruitView = view;
fruitImage = view.findViewById(R.id.fruit_image);
fruitName = view.findViewById(R.id.fruit_name);
}
}
/**
* 用于创建ViewHolder实例
* 将子布局加载进来,创建ViewHolder实例,将子布局传进去,
* @param parent
* @param viewType
* @return
*/
@NonNull
@Override
public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.fruit_item,parent,false);
final ViewHolder viewHolder = new ViewHolder(view);
viewHolder.fruitView.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
int position = viewHolder.getAdapterPosition();
Fruit fruit = myFruitList.get(position);
Toast.makeText(view.getContext(),"你点击了"+fruit.getName(),Toast.LENGTH_SHORT).show();
}
});
viewHolder.fruitImage.setOnClickListener(new View.OnClickListener(){
@Override
public void onClick(View view) {
int position = viewHolder.getAdapterPosition();
Fruit fruit = myFruitList.get(position);
Toast.makeText(view.getContext(),"你点击了图片"+fruit.getName(),Toast.LENGTH_SHORT).show();
}
});
return viewHolder;
}
/**
* 对子项赋值
* 在每个子项被滚动到屏幕内时执行
* @param holder
* @param position
*/
@Override
public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
Fruit fruit = myFruitList.get(position);
holder.fruitImage.setImageResource(fruit.getImageId());
holder.fruitName.setText(fruit.getName());
}
@Override
public int getItemCount() {
return myFruitList.size();
}
}
效果图:
点击列表
点击图片
横向滚动的RecyclerView
因为要实现横向滚动,所以子布局设置成垂直排列比较合理。
修改fruit_item.xml的代码:
在MainActivity的onCreate()方法中增加一句代码就可以实现横向滚动啦。
layoutManager.aetOrientation(LinearLayoutManager.HORIZONTAL);
RecyclerView还提供了GirdLayoutManager(实现网格布局)和StaggeredGirdLayoutManager(实现瀑布流布局)。
瀑布流布局的实现: