RecyclerView基本用法

RecyclerView基本用法

---

一、RecyclerView是什么？

用于替代ListView、GridView列表组件的一个新组件，刚发布时位于support-v7包内，后迁移到androidx后，作为独立库包含在jetpack套件库中

二、为什么要使用RecyclerView？

由于ListView、GridView原本的设计缺陷，只能实现相对简单的列表数据，对于复杂列表的需求场景（如横向列表、嵌套列表、列表和网格切换、瀑布流等）

原本的ListView实现困难且复杂，甚至有的需求需开发者完全重写组件，为了让开发者在不同的场景下，简单快速实现多样式列表的个性化需求，谷歌推出了组件RecyclerView，用于替代难以使用的ListView和GridView

通过使用灵活的LayoutManager，开发者可以轻松实现不同需求的布局：

三、如何使用RecyclerView？

• 在app modlue目录的build.gradle文件中引入RecyclerView库的依赖并同步工程：

implementation "androidx.recyclerview:recyclerview:1.1.0"

• 在xml布局文件中增加RecyclerView的标签，并指定使用的LayoutManager和orientation排列方向:

<androidx.recyclerview.widget.RecyclerView
	android:id="@+id/recyclerView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager" />

• 先创建一个条列表目用的布局文件 item_recyclerview.xml：

<?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"
    android:background="#88EEF8"
    android:padding="10dp">

    <TextView
        android:id="@+id/itemTextView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="张三"
        android:textColor="#FF000000" />
</RelativeLayout>

• 为RecyclerView创建一个Adapter适配器：

class MyAdapter extends RecyclerView.Adapter<MyAdapter.MyViewHolder> {

    @NonNull
    @Override
    public MyAdapter.MyViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.item_recyclerview, parent, false);
        return new MyViewHolder(itemView);
    }

    @Override
    public void onBindViewHolder(@NonNull MyAdapter.MyViewHolder holder, int position) {
        holder.textView.setText("Item " + position);
        holder.textView.setTextColor(Color.RED);
    }

    @Override
    public int getItemCount() {
        return 20;
    }

    class MyViewHolder extends RecyclerView.ViewHolder {

        TextView textView;

        public MyViewHolder(@NonNull View itemView) {
            super(itemView);
            textView = itemView.findViewById(R.id.itemTextView);
        }

    }
}

• 在Activity/Fragment为RecyclerView设置适配器：

RecyclerView recyclerView = findViewById(R.id.recyclerView);
recyclerView.setAdapter(new MyAdapter());

• 运行：

• 一行代码添加分割线：

recyclerView.addItemDecoration(new DividerItemDecoration(this, DividerItemDecoration.VERTICAL));

• 一行代码切换到网格布局：

recyclerView.setLayoutManager(new GridLayoutManager(this, 3));

后面再更新进阶用法~