Android RecyclerView 列表示例

2025年3月17日 | 阅读 3 分钟

RecyclerView 类扩展了 ViewGroup 类并实现了 ScrollingView 接口。它是在 Marshmallow 中引入的。它是 ListView 的高级版本，具有改进的性能和其他优点。RecyclerView 主要用于使用对 Android 应用程序的列表和网格的细粒度控制来设计用户界面。

在本教程中，我们将使用 RecyclerView 创建一个包含 ImageView（用于图标）和 TextView（用于描述）的项目列表，并对其列表项执行点击监听器。

Android RecyclerView 与列表示例

创建一个 Android 项目，并在 build.gradle 文件中添加 RecyclerView 支持库 com.android.support:recyclerview-v7:23.1.0 或更高版本。

在布局目录中的 activity_main.xml 文件中，添加 RecyclerView 小部件。

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<android.support.v7.widget.RecyclerView
        xmlns:android="http://schemas.android.com/apk/res/android"
        xmlns:tools="http://schemas.android.com/tools"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scrollbars="vertical"
        android:id="@+id/recyclerView"
        tools:context="example.javatpoint.com.recyclerviewlist.MainActivity">

</android.support.v7.widget.RecyclerView>

在 values 目录中创建一个 dimens.xml 文件，并添加以下代码。

dimens.xml

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <dimen name="activity_horizontal_margin">16dp</dimen>
    <dimen name="activity_vertical_margin">16dp</dimen>
    <dimen name="ic_clear_margin">56dp</dimen>
</resources>

创建一个自定义布局 list_item.xml 文件，代码如下。

list_item.xml

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/relativeLayout"
    android:layout_width="match_parent"
    android:layout_height="?android:attr/listPreferredItemHeightLarge"
    android:background="@drawable/border">

    <ImageView
        android:id="@+id/imageView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerVertical="true"
        android:layout_alignParentStart="true"
        android:layout_alignParentLeft="true"
        android:layout_marginStart="@dimen/activity_horizontal_margin"
        android:layout_marginEnd="@dimen/activity_horizontal_margin"
        android:contentDescription="Icon" />

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_toEndOf="@id/imageView"
        android:layout_toRightOf="@id/imageView"
        android:gravity="center_vertical"
        android:textSize="16sp"/>

</RelativeLayout>

在 drawable 目录中创建一个 border.xml 文件，用于装饰 RecyclerView 项的边框。

border.xml

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle">
    <solid android:color="#FFFFFF" />
    <stroke
        android:width="1dp"
        android:color="#CCCCCC" />
</shape>

创建一个 MyListData.java 类，代码如下。此类别用作 (POJO) 类，用于设置项目属性。

MyListData.java

package example.javatpoint.com.recyclerviewlist;
public class MyListData{
    private String description;
    private int imgId;
    public MyListData(String description, int imgId) {
        this.description = description;
        this.imgId = imgId;
    }
    public String getDescription() {
        return description;
    }
    public void setDescription(String description) {
        this.description = description;
    }
    public int getImgId() {
        return imgId;
    }
    public void setImgId(int imgId) {
        this.imgId = imgId;
    }
}

创建一个 MyListAdapter.java 类并添加以下代码。此类别扩展了 RecyclerView.Adapter 类并覆盖其未实现的方法。onCreateViewHolder() 方法会填充 list_item.xml。在 onBindViewHolder() 方法中，每个数据项都设置到每一行。

MyListAdapter.java

package example.javatpoint.com.recyclerviewlist;

import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.ImageView;
import android.widget.RelativeLayout;
import android.widget.TextView;
import android.widget.Toast;


public class MyListAdapter extends RecyclerView.Adapter<MyListAdapter.ViewHolder>{
    private MyListData[] listdata;

   // RecyclerView recyclerView;
    public MyListAdapter(MyListData[] listdata) {
        this.listdata = listdata;
    }
    @Override
    public ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        LayoutInflater layoutInflater = LayoutInflater.from(parent.getContext());
        View listItem= layoutInflater.inflate(R.layout.list_item, parent, false);
        ViewHolder viewHolder = new ViewHolder(listItem);
        return viewHolder;
    }

    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        final MyListData myListData = listdata[position];
        holder.textView.setText(listdata[position].getDescription());
        holder.imageView.setImageResource(listdata[position].getImgId());
        holder.relativeLayout.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Toast.makeText(view.getContext(),"click on item: "+myListData.getDescription(),Toast.LENGTH_LONG).show();
            }
        });
    }


    @Override
    public int getItemCount() {
        return listdata.length;
    }

    public static class ViewHolder extends RecyclerView.ViewHolder {
        public ImageView imageView;
        public TextView textView;
        public RelativeLayout relativeLayout;
        public ViewHolder(View itemView) {
            super(itemView);
            this.imageView = (ImageView) itemView.findViewById(R.id.imageView);
            this.textView = (TextView) itemView.findViewById(R.id.textView);
            relativeLayout = (RelativeLayout)itemView.findViewById(R.id.relativeLayout);
        }
    }
}

最后，在 MainActivity.java 类中，添加以下代码。此类别为 MyListData 类创建项目数组，并将适配器类设置到 RecyclerView。

MainActivity.java

package example.javatpoint.com.recyclerviewlist;

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        MyListData[] myListData = new MyListData[] {
                new MyListData("Email", android.R.drawable.ic_dialog_email),
                new MyListData("Info", android.R.drawable.ic_dialog_info),
                new MyListData("Delete", android.R.drawable.ic_delete),
                new MyListData("Dialer", android.R.drawable.ic_dialog_dialer),
                new MyListData("Alert", android.R.drawable.ic_dialog_alert),
                new MyListData("Map", android.R.drawable.ic_dialog_map),
                new MyListData("Email", android.R.drawable.ic_dialog_email),
                new MyListData("Info", android.R.drawable.ic_dialog_info),
                new MyListData("Delete", android.R.drawable.ic_delete),
                new MyListData("Dialer", android.R.drawable.ic_dialog_dialer),
                new MyListData("Alert", android.R.drawable.ic_dialog_alert),
                new MyListData("Map", android.R.drawable.ic_dialog_map),
        };

        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recyclerView);
        MyListAdapter adapter = new MyListAdapter(myListData);
        recyclerView.setHasFixedSize(true);
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        recyclerView.setAdapter(adapter);
    }
}

输出

下一个主题滑动删除 RecyclerView

← prev next →

Android RecyclerView 列表示例

Android RecyclerView 与列表示例

activity_main.xml

dimens.xml

list_item.xml

border.xml

MyListData.java

MyListAdapter.java

MainActivity.java

联系信息

关注我们

教程

面试题

在线编译器

Python

Java

.Net Framework

AI, ML and Data Science

Cloud Technology

B.Tech and MCA

Web Technology

PHP

Software Testing

Technical Interview

Java Interview

Python

Web Interview

Database Interview

B.Tech / MCA

Important Interview

Software Testing Interview

Company Interviews

Online Compilers

Multiple Choice Questions

相机教程

Android 测验

Android 面试

Android MCQ

Android 杂项

Android 版本

Android 社交

Android 示例

添加广告

Google 地图

Android Web Service

Android 动画

Android 图形

传感器教程

Android 教程

安卓设备

Android 电信

Android 语音

Android 多媒体

XML 和 JSON

Android SQLite

Android 存储

Android AlarmManager

Android Service

Android Menu

Android Fragments

Activity 和 Intents

Android Widgets

Android RecyclerView 列表示例

Android RecyclerView 与列表示例

activity_main.xml

dimens.xml

list_item.xml

border.xml

MyListData.java

MyListAdapter.java

MainActivity.java

相关帖子

RSS Feed 阅读器

使用 Google reCAPTCHA

Intro Slider

Android Linkify

Firebase Authentication - Google 登录

QR/条形码扫描器

网络连接服务

Android 通知

Swipe Del RecyclerView

Volley Library 注册 登录 登出

订阅 Tpoint Tech

联系信息

关注我们

教程

面试题

在线编译器

Volley Library 注册登录登出