使用GridLayoutManager的简单Android网格示例，使用RecyclerView（类似于旧的GridView）

Question

我知道RecyclerView已经取代了旧的ListView和GridView的功能。我正在寻找一个非常基本的示例，展示使用RecyclerView进行最小网格设置的方法。我不需要冗长的教程风格解释，只需要一个最简单的例子即可。我想象中最简单的网格将模仿旧的GridView，并具备以下特点：

• 每行多个单元格
• 每个单元格中仅包含一个视图
• 响应点击事件

- Suragch

Answer 1

简短回答

对于那些已经熟悉如何设置RecyclerView以生成列表的人，好消息是制作网格基本相同。当您设置RecyclerView时，只需使用GridLayoutManager而不是LinearLayoutManager。

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

如果你需要比这更多的帮助，可以查看以下示例。

完整示例

以下是一个最小化的示例，它将看起来像下面的图片。

从一个空活动开始。您将执行以下任务，添加 RecyclerView 网格。您只需要在每个部分中复制并粘贴代码即可。稍后，您可以将其自定义以适应您的需求。

• 添加 gradle 依赖项
• 添加用于活动和网格单元的 XML 布局文件
• 创建 RecyclerView 适配器
• 在活动中初始化 RecyclerView

更新 Gradle 依赖项

确保以下依赖项在您的应用程序 gradle.build 文件中：

compile 'com.android.support:appcompat-v7:27.1.1'
compile 'com.android.support:recyclerview-v7:27.1.1'

您可以将版本号更新为最新版本。

创建活动布局

将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/rvNumbers"
        android:layout_width="match_parent"
        android:layout_height="match_parent"/>

</RelativeLayout>

创建网格单元布局

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

recyclerview_item.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:padding="5dp"
    android:layout_width="50dp"
    android:layout_height="50dp">

        <TextView
            android:id="@+id/info_text"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:gravity="center"
            android:background="@color/colorAccent"/>

</LinearLayout>

创建适配器

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

MyRecyclerViewAdapter.java

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

    private String[] mData;
    private LayoutInflater mInflater;
    private ItemClickListener mClickListener;

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

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

    // binds the data to the TextView in each cell
    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        holder.myTextView.setText(mData[position]);
    }

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


    // 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.info_text);
            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[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);
    }
}

注意事项

• 虽然不是必需的，但我添加了在单元格上监听点击事件的功能。这在旧版GridView中可用并且是一个常见需求。如果您不需要此功能，可以将该代码删除。

在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
        String[] data = {"1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48"};

        // set up the RecyclerView
        RecyclerView recyclerView = findViewById(R.id.rvNumbers);
        int numberOfColumns = 6;
        recyclerView.setLayoutManager(new GridLayoutManager(this, numberOfColumns));
        adapter = new MyRecyclerViewAdapter(this, data);
        adapter.setClickListener(this);
        recyclerView.setAdapter(adapter);
    }

    @Override
    public void onItemClick(View view, int position) {
        Log.i("TAG", "You clicked number " + adapter.getItem(position) + ", which is at cell position " + position);
    }
}

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

完成

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

接下来

圆角

• 使用CardView

自适应列数

• GridLayoutManager - 如何自适应列？

进一步学习

• 带有GridView GridLayoutManager的Android RecyclerView示例教程
• Android RecyclerView网格布局示例
• 通过Android示例学习RecyclerView
• RecyclerView：带标题的网格
• Android GridLayoutManager在Material Design中与RecyclerView一起使用
• 在Android上开始使用RecyclerView和CardView

- Suragch

---

@MarianPaździoch，是的，我只是把它做成了一个最简示例。它肯定需要一些美化工作。我将尝试在未来更新这个答案。 - Suragch

我特意登录只是为了指出像你这样的人让这个门户网站保持活力。在看到这个解决方案之前，我被卡了两天。非常感谢！ - VarunJoshi129

@androiddeveloper，网格项从左到右，从上到下布局。当屏幕上无法容纳更多的项目时，滚动是垂直的。 - Suragch

未来的读者，让我为你节省一些时间。关键是 recyclerView.setLayoutManager(new GridLayoutManager(this, numberOfColumns));。 - olfek

@daka，说得好。我编辑了我的答案，在开头加入了这个。 - Suragch

Answer 2

这是一种仅使用XML的简单方法

spanCount用于指定列数

layoutManager用于将其设置为网格或线性（垂直或水平）

<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/personListRecyclerView"
    android:layout_width="0dp"
    android:layout_height="0dp"
    app:layoutManager="androidx.recyclerview.widget.GridLayoutManager"
    app:spanCount="2" />

- Hamdy Abd El Fattah

Answer 3

虽然我喜欢并赞赏Suragch的答案，但我想留个注释，因为我发现编写适配器 (MyRecyclerViewAdapter) 来定义和公开监听器方法 onItemClick 并不是最好的方式，因为它未正确使用类封装。所以我的建议是让适配器仅处理监听操作(这是它的目的!)，并将其与使用适配器(MainActivity)的活动分离。下面是我如何设置适配器类:

MyRecyclerViewAdapter.java

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

    private String[] mData = new String[0];
    private LayoutInflater mInflater;

    // Data is passed into the constructor
    public MyRecyclerViewAdapter(Context context, String[] data) {
        this.mInflater = LayoutInflater.from(context);
        this.mData = data;
    }

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

    // Binds the data to the textview in each cell
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        String animal = mData[position];
        holder.myTextView.setText(animal);
    }

    // Total number of cells
    @Override
    public int getItemCount() {
        return mData.length;
    }

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

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

        @Override
        public void onClick(View view) {
            onItemClick(view, getAdapterPosition());
        }
    }

    // Convenience method for getting data at click position
    public String getItem(int id) {
        return mData[id];
    }

    // Method that executes your code for the action received
    public void onItemClick(View view, int position) {
        Log.i("TAG", "You clicked number " + getItem(position).toString() + ", which is at cell position " + position);
    }
}

请注意在MyRecyclerViewAdapter中现在定义了onItemClick方法，这是您想编写事件/操作任务的位置。

为完成此转换只需进行一项小更改：由于现在完全由适配器完成，因此Activity不再需要实现MyRecyclerViewAdapter.ItemClickListener。这将是最终的修改： MainActivity.java

public class MainActivity extends AppCompatActivity {

    MyRecyclerViewAdapter adapter;

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

        // data to populate the RecyclerView with
        String[] data = {"1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48"};

        // set up the RecyclerView
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.rvNumbers);
        int numberOfColumns = 6;
        recyclerView.setLayoutManager(new GridLayoutManager(this, numberOfColumns));
        adapter = new MyRecyclerViewAdapter(this, data);
        adapter.setClickListener(this);
        recyclerView.setAdapter(adapter);
    }
}

- jonypera

---

如果这个活动确实需要监听点击事件怎么办？例如，将数据传递给Presenter，在基于所选项目执行一些逻辑、跟踪等。 - Fadli

我同意 Adapter 应该处理点击事件，因为它具有其中的数据项。如果你需要在 Adapter 的宿主（Fragment 或 Activity）中进行一些工作，你应该创建一个回调接口，并在其中定义所需的方法。然后，你的宿主实现这个接口。接着，将宿主的实例传递到 Adapter 的构造函数中。有了宿主的实例，你可以在 Adapter 中需要时调用它的方法。这通常用于需要使用 ActionMode 时。当你长按选择项目并使用 ActionBar 按钮时，我们会得到回调。 - Kirill Karmazin

我不同意，认为点击事件应该在托管“Activity”中处理。因为只有它的点击监听器才能知道关于“Activity”视图和其他“Fragments”，“Activities”等的信息。适配器只能将点击事件发送到上层。它应该具有接口“ItemClickListener”，其中包含许多事件，与适配器视图可以产生的事件一样多。这个解决方案甚至早在此之前就已经被写出来了：https://dev59.com/blwY5IYBdhLWcg3wWWq0#40563598。 - CoolMind

Answer 4

你需要将你的 RecyclerView 的 LayoutManager 模式设置为 Gridlayout 模式。当你想要设置 RecyclerView 的 LayoutManager 时，只需更改你的代码：

recyclerView.setLayoutManager(new GridLayoutManager(getActivity(), numberOfColumns));

- MR Coder

Answer 5

    There are 2 ways to achieve this 
    
    - In Xml
     <androidx.recyclerview.widget.RecyclerView
                            android:id="@+id/list_amenities"
                            android:layout_width="0dp"
                            android:layout_height="wrap_content"
                            android:layout_marginTop="@dimen/_8sdp"
                            android:nestedScrollingEnabled="false"                 
 app:layoutManager="androidx.recyclerview.widget.GridLayoutManager"
                            app:spanCount="2"
app:layout_constraintEnd_toEndOf="@+id/text_parking_lot_amenities"                       app:layout_constraintStart_toStartOf="@+id/text_parking_lot_amenities"                  app:layout_constraintTop_toBottomOf="@id/text_parking_lot_amenities" />

span count 用于网格列的设置。
- 在活动中使用。

 listAmenities.layoutManager = GridLayoutManager(this, TWO)
 here TWO indicates number of grid columns

- Nandini

Answer 6

在初始化RecyclerView时设置

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

- user14031748

---

它与其他答案有何不同？ - CoolMind

Answer 7

如果您想在xml文件中为RecyclerView设置网格布局，则可以将以下两个内容放入RecyclerView xml中。

app:layoutManager="androidx.recyclerview.widget.GridLayoutManager"
app:spanCount=numberOfItemsInSignleRow

如果您想从Java代码设置网格布局，可以编写以下内容。

recyclerView.setLayoutManager(new GridLayoutManager(getActivity(), numberOfItemsInSignleRow));

- Hammad Zafar Bawara

Answer 8

在你的MainActivity中，当你给recycler view分配了值时，只需使用这段代码。

recyclerView = findViewById(R.id.recycler_view);
    recyclerView.setHasFixedSize(true);
    //recyclerView.setLayoutManager(new LinearLayoutManager(this));
    recyclerView.setLayoutManager(new GridLayoutManager(this, 2));

- A.I.Shakil