RecyclerView基础知识

最新推荐文章于 2025-05-11 20:57:07 发布

fly猪猪7

最新推荐文章于 2025-05-11 20:57:07 发布

阅读量217

点赞数

分类专栏： Android 文章标签： android

本文链接：https://blog.youkuaiyun.com/weixin_45922212/article/details/112576316

版权

Android 专栏收录该内容

4 篇文章

订阅专栏

本文介绍了Android中RecyclerView的基本用法。需在build.gradle添加依赖，在activity_main.xml加入控件。定义适配器要重写三个方法，还说明了如何修改MainActivity.java代码。此外，讲解了实现横向滚动、瀑布流布局的方法，以及RecyclerView点击事件的处理。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

RecyclerView的基本用法

谷歌把RecyclerView控件定义在了AndroidX当中，所以我们要在build.gradle中添加RecyclerView库的依赖。

打开app/build.gradle文件，在depandencies闭包中添加如下内容：
```
implementation 'androidx.recyclerview:recyclerview:1.1.0'
```
ps：上诉代码版本号以后可能发生改变，需要根据提示进行同步

在activity_main.xml中加入RecyclerView控件：

<?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="match_parent">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</LinearLayout>

注意：由于RecyclerView不是内置在系统SDK当中，所以要把完整的包路径写出来

这里实现的是和ListView相同的效果，Fruit类和fruit_item.xml和ListView时的代码一样。

代码参考另一篇文章：ListView基础知识

为RecyclerView定义一个适配器

public class FruitAdapter extends RecyclerView.Adapter<FruitAdapter.ViewHolder> {

    private List<Fruit> mFruitList;

    //此构造器用于把数据传进来
    public FruitAdapter(List<Fruit> fruitList) {
        mFruitList = fruitList;
    }

    static class ViewHolder extends RecyclerView.ViewHolder {
        ImageView fruitImage;
        TextView fruitName;

        //构造器中的view参数通常是RecyclerView子项的最外层布局
        public ViewHolder(@NonNull View itemView) {
            super(itemView);
            fruitImage = itemView.findViewById(R.id.fruit_image);
            fruitName = itemView.findViewById(R.id.fruit_name);
        }
    }

    /**
     * 此方法用于创建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);
        ViewHolder holder = new ViewHolder(view);
        return holder;
    }

    /**
     * 此方法用于对RecyclerView子项的数据进行赋值，在每一个子项被滚动到屏幕时执行
     * @param holder
     * @param position
     */
    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        Fruit fruit = mFruitList.get(position);
        holder.fruitImage.setImageResource(fruit.getImageId());
        holder.fruitName.setText(fruit.getName());
    }
    
    @Override
    public int getItemCount() {
        return mFruitList.size();
    }

}

上诉代码中，首先定义了一个内部类ViewHolder，继承自RecyclerView.ViewHolder。ViewHolder构造器要传入RecyclerView子项最外层布局View参数，并在构造器中调用findViewById()方法获取布局中的实例。

FruitAdapter的构造器用于将数据源传递进来。

FruitAdapter继承自RecyclerView.Adapter，所以要重写三个方法：

onCreateViewHolder()方法：用于创建ViewHolder实例，并把加载出来的布局传递到构造器中，然后把ViewHolder实例返回。

onBindViewHolder()方法：用于对RecyclerView子项的数据进行赋值，在每一个子项被滚动到屏幕时执行。

getItemCount()方法：返回RecyclerView子项的个数

修改MainActivity.java的onCreate()方法代码（初始化数据和定义List同ListView）：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    initFruits();
    RecyclerView recyclerView = findViewById(R.id.recycler_view);
    LinearLayoutManager layoutManager = new LinearLayoutManager(this);
    recyclerView.setLayoutManager(layoutManager);
    FruitAdapter adapter = new FruitAdapter(fruitList);
    recyclerView.setAdapter(adapter);
}

在上诉代码中首先获取到RecylerView实例，然后创建一个布局LinearLayoutManager（线性布局管理器）对象，并把它设置到RecyclerView当中，接着创建一个FruitAdapter对象，并通过构造器传递数据。最后调用RecyclerView的setAdapter()方法设置适配器即可。

实现横向滚动

首先要对fruit_item布局进行修改。因为目前这个布局里的元素是水平排列的，使用于纵向滚动。如果要实现横向滚动，需要把布局里的元素改成垂直排列。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="100dp"
    android:layout_height="wrap_content"
    android:orientation="vertical">

    <ImageView
        android:id="@+id/fruit_image"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"/>

    <TextView
        android:id="@+id/fruit_name"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"
        android:layout_marginTop="10dp"/>

</LinearLayout>

在MainActivity.java中的onCreate()方法修改代码，在创建布局管理器实例代码的后面加上下面一行代码：
```
layoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);
```

实现瀑布流布局

修改fruit_item.xml中的代码：

<?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"
    android:orientation="vertical"
    android:layout_margin="5dp">

    <ImageView
        android:id="@+id/fruit_image"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal"/>

    <TextView
        android:id="@+id/fruit_name"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="left"
        android:layout_marginTop="10dp"/>

</LinearLayout>

修改MainActivity中的代码：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    initFruits();
    RecyclerView recyclerView = findViewById(R.id.recycler_view);
    StaggeredGridLayoutManager layoutManager = new
            StaggeredGridLayoutManager(3, StaggeredGridLayoutManager.VERTICAL);
    recyclerView.setLayoutManager(layoutManager);
    FruitAdapter adapter = new FruitAdapter(fruitList);
    recyclerView.setAdapter(adaptetar);
}

private void initFruits() {
    Fruit apple;
    for (int i = 0; i < 40; i++) {
    	//使用随机数生成不同长度的水果名，这样才能看出瀑布流布局的效果
        Random random = new Random();
        StringBuilder name = new StringBuilder();
        for (int j = 0; j < random.nextInt(20) + 1; j++) {
            name.append("Apple");
        }
        apple = new Fruit(name.toString(), R.drawable.apple_pic);
        fruitList.add(apple);
    }

}

在上诉代码中，我们创建了一个StaggeredGridLayoutManager的实例，它的构造器接收两个参数，第一个用于指定布局的列数，第二个用于指定布局的排列方向

RecyclerView的点击事件

RecyclerView没有提供类似于setOnItemClickListener()这样注册监听器的方法，需要我们自己给item注册点击事件。

修改FruitAdapter中的代码：

static class ViewHolder extends RecyclerView.ViewHolder {
    View fruitView;
    ImageView fruitImage;
    TextView fruitName;

    //构造器中的view参数通常是RecyclerView子项的最外层布局
    public ViewHolder(@NonNull View itemView) {
        super(itemView);
        fruitView = itemView;
        fruitImage = itemView.findViewById(R.id.fruit_image);
        fruitName = itemView.findViewById(R.id.fruit_name);
    }
}

/**
 * 此方法用于创建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 holder = new ViewHolder(view);
    holder.fruitView.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            int position = holder.getAdapterPosition();
            Fruit fruit = mFruitList.get(position);
            Toast.makeText(view.getContext(), "you click view " + fruit.getName(), Toast.LENGTH_SHORT).show();
        }
    });
    holder.fruitImage.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            int position = holder.getAdapterPosition();
            Fruit fruit = mFruitList.get(position);
            Toast.makeText(view.getContext(), "you click image " + fruit.getName(), Toast.LENGTH_SHORT).show();
        }
    });
    return holder;
}

上诉代码中，在ViewHolder中添加了一个fruitView用来保存子项最外层布局实例，然后在onCreateViewHolder()方法中注册监听事件即可。