简单的Android RecyclerView示例

我用Android的RecyclerView做过几次物品列表，但这是一个相当复杂的过程。浏览众多在线教程中的一个作品(这个，这个，这个都很好)，但我正在寻找一个简单的示例，我可以复制和粘贴来快速启动和运行。只需要以下特性:

垂直布局每行都有一个单一的TextView 响应点击事件

因为这个愿望我已经许过好几次了，所以我最终决定把答案写在下面，供我和你们将来参考。

当前回答

下面是一个类似下图的最小示例。

从一个空活动开始。您将执行以下任务来添加RecyclerView。您所需要做的就是复制并粘贴每个部分中的代码。稍后，您可以自定义它以满足您的需求。

向gradle添加依赖项为活动和RecyclerView行添加xml布局文件制作RecyclerView适配器初始化活动中的RecyclerView

更新Gradle依赖项

确保以下依赖项在你的应用程序gradle中。构建文件:

implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support:recyclerview-v7:28.0.0'

您可以将版本号更新为最新的版本号。如果你还在使用Android Studio 2.x，请使用编译而不是实现。

创建活动布局

将RecyclerView添加到xml布局中。

activity_main.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="match_parent">

    <android.support.v7.widget.RecyclerView
        android:id="@+id/rvAnimals"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</RelativeLayout>

创建行布局

我们的RecyclerView中的每一行都只会有一个单一的TextView。创建一个新的布局资源文件。

recyclerview_row.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="horizontal"
    android:padding="10dp">

    <TextView
        android:id="@+id/tvAnimalName"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="20sp"/>

</LinearLayout>

创建适配器

RecyclerView需要一个适配器来用您的数据填充每行中的视图。创建一个新的java文件。

MyRecyclerViewAdapter.java

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

    private List<String> mData;
    private LayoutInflater mInflater;
    private ItemClickListener mClickListener;

    // data is passed into the constructor
    MyRecyclerViewAdapter(Context context, List<String> data) {
        this.mInflater = LayoutInflater.from(context);
        this.mData = data;
    }

    // inflates the row layout from xml when needed
    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View view = mInflater.inflate(R.layout.recyclerview_row, parent, false);
        return new ViewHolder(view);
    }

    // binds the data to the TextView in each row
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        String animal = mData.get(position);
        holder.myTextView.setText(animal);
    }

    // total number of rows
    @Override
    public int getItemCount() {
        return mData.size();
    }


    // stores and recycles views as they are scrolled off screen
    public class ViewHolder extends RecyclerView.ViewHolder implements View.OnClickListener {
        TextView myTextView;

        ViewHolder(View itemView) {
            super(itemView);
            myTextView = itemView.findViewById(R.id.tvAnimalName);
            itemView.setOnClickListener(this);
        }

        @Override
        public void onClick(View view) {
            if (mClickListener != null) mClickListener.onItemClick(view, getAdapterPosition());
        }
    }

    // convenience method for getting data at click position
    String getItem(int id) {
        return mData.get(id);
    }

    // allows clicks events to be caught
    void setClickListener(ItemClickListener itemClickListener) {
        this.mClickListener = itemClickListener;
    }

    // parent activity will implement this method to respond to click events
    public interface ItemClickListener {
        void onItemClick(View view, int position);
    }
}

笔记

虽然不是严格必要的，但我包含了监听行上的单击事件的功能。这在旧的listview中是可用的，是一种常见的需求。如果不需要，可以删除此代码。

在Activity中初始化RecyclerView

将以下代码添加到您的主活动中。

MainActivity.java

public class MainActivity extends AppCompatActivity implements MyRecyclerViewAdapter.ItemClickListener {

    MyRecyclerViewAdapter adapter;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // data to populate the RecyclerView with
        ArrayList<String> animalNames = new ArrayList<>();
        animalNames.add("Horse");
        animalNames.add("Cow");
        animalNames.add("Camel");
        animalNames.add("Sheep");
        animalNames.add("Goat");

        // set up the RecyclerView
        RecyclerView recyclerView = findViewById(R.id.rvAnimals);
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        adapter = new MyRecyclerViewAdapter(this, animalNames);
        adapter.setClickListener(this);
        recyclerView.setAdapter(adapter);
    }

    @Override
    public void onItemClick(View view, int position) {
        Toast.makeText(this, "You clicked " + adapter.getItem(position) + " on row number " + position, Toast.LENGTH_SHORT).show();
    }
}

笔记

注意，该活动实现了我们在适配器中定义的ItemClickListener。这允许我们在onItemClick中处理行单击事件。

完成了

就是这样。您现在应该能够运行您的项目，并获得与顶部图像类似的内容。

发生了

在行之间添加分隔符

你可以像这样加一个简单的分隔符

DividerItemDecoration dividerItemDecoration = new DividerItemDecoration(recyclerView.getContext(),
    layoutManager.getOrientation());
recyclerView.addItemDecoration(dividerItemDecoration);

如果你想要一些更复杂的东西，请参阅以下答案:

如何在RecyclerView中添加项目之间的分隔符和空格? 如何在线性布局中缩进分隔符(即，仅在ItemDecoration中添加填充，边距或插入)

在单击时更改行颜色

查看这个答案，了解如何更改背景颜色，并在单击一行时添加涟漪效应。

更新的行

有关如何添加、删除和更新行，请参阅此回答。

进一步的阅读

CodePath 视频教程 Android RecyclerView示例(stacktips教程) RecyclerView在Android:教程

2016-11-14 08:19:36

其他回答

实现androidx.recyclerview: recyclerview:… 建议更新到下面的androidx库:

https://developer.android.com/jetpack/androidx/releases/recyclerview

布局文件Widget XML标签必须更新为: androidx.recyclerview.widget.RecyclerView

2019-08-19 09:37:51