安卓GridView（自定义适配器）

封面图 • 2025-10-20 • Android开发

在 Android 开发中，`GridView` 是一个用于显示**网格布局**的控件，适合展示图片、图标等需要按行列排列的元素。使用 **自定义适配器（Custom Adapter）** 可以更灵活地控制 `GridView` 中每个 item 的显示方式。

---

## ✅ 一、基本概念

### 1. `GridView`
- 显示为网格形式的列表。
- 支持水平和垂直滚动。
- 每个 item 是一个视图（View）。

### 2. 自定义适配器
- 通常继承自 `BaseAdapter` 或 `ArrayAdapter`。
- 提供 `getView()` 方法来返回每个 item 的视图。
- 适用于数据源复杂或需要自定义 UI 的情况。

---

## ✅ 二、实现步骤

### 1. 布局文件：`activity_main.xml`

```xml
<GridView
    android:id="@+id/gridView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:numColumns="2"  
    android:verticalSpacing="10dp"
    android:horizontalSpacing="10dp"
    android:padding="10dp"/>
```

### 2. 数据模型类（可选）

如果你的数据是图片资源，可以创建一个 `ImageItem` 类：

```java
public class ImageItem {
    private String name;
    private int resourceId;

public ImageItem(String name, int resourceId) {
        this.name = name;
        this.resourceId = resourceId;
    }

public String getName() {
        return name;
    }

public int getResourceId() {
        return resourceId;
    }
}
```

### 3. 自定义适配器 `GridAdapter.java`

```java
import android.content.Context;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.BaseAdapter;
import android.widget.ImageView;

import java.util.List;

public class GridAdapter extends BaseAdapter {
    private Context context;
    private List<ImageItem> imageItems;

public GridAdapter(Context context, List<ImageItem> imageItems) {
        this.context = context;
        this.imageItems = imageItems;
    }

@Override
    public int getCount() {
        return imageItems.size();
    }

@Override
    public Object getItem(int position) {
        return imageItems.get(position);
    }

@Override
    public long getItemId(int position) {
        return position;
    }

@Override
    public View getView(int position, View convertView, ViewGroup parent) {
        if (convertView == null) {
            LayoutInflater inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
            convertView = inflater.inflate(R.layout.grid_item, parent, false);
        }

ImageView imageView = convertView.findViewById(R.id.imageView);
        ImageItem item = imageItems.get(position);
        imageView.setImageResource(item.getResourceId());

return convertView;
    }
}
```

### 4. `grid_item.xml`（每个 item 的布局）

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

<ImageView
        android:id="@+id/imageView"
        android:layout_width="100dp"
        android:layout_height="100dp"
        android:scaleType="centerCrop" />
</LinearLayout>
```

### 5. 在 `MainActivity.java` 中设置 GridView

```java
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import android.widget.GridView;

import java.util.ArrayList;
import java.util.List;

public class MainActivity extends AppCompatActivity {

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

GridView gridView = findViewById(R.id.gridView);

// 准备数据
        List<ImageItem> imageItems = new ArrayList<>();
        imageItems.add(new ImageItem("Image 1", R.drawable.image1));
        imageItems.add(new ImageItem("Image 2", R.drawable.image2));
        imageItems.add(new ImageItem("Image 3", R.drawable.image3));
        imageItems.add(new ImageItem("Image 4", R.drawable.image4));

// 设置适配器
        GridAdapter adapter = new GridAdapter(this, imageItems);
        gridView.setAdapter(adapter);
    }
}
```

---

## ✅ 三、注意事项

- `GridView` 默认不会自动加载图片，如果图片较大，建议使用 Glide 或 Picasso 等图片加载库。
- `BaseAdapter` 需要自己实现 `getCount()`、`getItem()`、`getItemId()` 和 `getView()`。
- 使用 `ViewHolder` 模式优化性能（可选但推荐）。

---

## ✅ 四、使用 ViewHolder 优化（可选）

```java
@Override
public View getView(int position, View convertView, ViewGroup parent) {
    ViewHolder holder;
    if (convertView == null) {
        LayoutInflater inflater = (LayoutInflater) context.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
        convertView = inflater.inflate(R.layout.grid_item, parent, false);
        holder = new ViewHolder();
        holder.imageView = convertView.findViewById(R.id.imageView);
        convertView.setTag(holder);
    } else {
        holder = (ViewHolder) convertView.getTag();
    }

ImageItem item = imageItems.get(position);
    holder.imageView.setImageResource(item.getResourceId());

return convertView;
}

static class ViewHolder {
    ImageView imageView;
}
```

---

## ✅ 五、总结

| 组件 | 功能 |
|------|------|
| `GridView` | 显示网格布局的控件 |
| `BaseAdapter` | 自定义适配器，控制每个 item 的显示 |
| `getView()` | 返回每个 item 的视图 |
| `ViewHolder` | 优化性能，避免频繁调用 findViewById |

---

如需进一步扩展功能（如点击事件、图片懒加载、动态添加数据等），欢迎继续提问！