GridLayoutManager 网格布局与 RecyclerView 拖拽侧滑实战

GridLayoutManager 概述

在 Android 开发中，RecyclerView 是构建灵活列表和网格布局的核心组件，GridLayoutManager 作为 RecyclerView 的布局管理器，能轻松实现多样化的网格排列效果。结合 ItemTouchHelper 辅助类，还能快速为 RecyclerView 添加拖拽排序和侧滑删除功能。本文将详细讲解 、GridLayoutManager 的使用技巧，以及拖拽、侧滑功能的完整实现流程，帮助开发者打造更具交互性的 UI 界面。

主要特点：

• 可设置列数（水平方向）或行数（垂直方向）
• 支持横向和纵向网格布局
• 与 RecyclerView 结合使用，实现高效的数据展示

---

一、GridLayoutManager：灵活控制网格布局

GridLayoutManager 是 RecyclerView 专门用于网格布局的管理器，支持自定义列数、滚动方向，还能实现单个 item 占据多格的复杂布局，比传统的 GridView 更具灵活性。

1. 核心构造方法

GridLayoutManager 提供了多个构造方法，最常用的是支持指定滚动方向和反向布局的重载方法：

GridLayoutManager(Context context, int spanCount, int orientation, boolean reverseLayout)

参数说明：

• context：上下文对象，通常为 Activity 或 Fragment
• spanCount：网格的列数（垂直滚动时）或行数（水平滚动时）
• orientation：滚动方向，可选GridLayoutManager.VERTICAL（垂直滚动）或GridLayoutManager.HORIZONTAL（水平滚动）
• reverseLayout：是否反向布局，true 时垂直布局从底部开始，水平布局从右侧开始

示例：创建一个 3 列垂直滚动的网格布局

// 创建GridLayoutManager，指定列数 3列
GridLayoutManager layoutManager = new GridLayoutManager(context, 3); //

// 设置布局管理器
recyclerView.setLayoutManager(layoutManager);

2. 自定义 Item 占据格子数（SpanSizeLookup）

默认情况下，每个 item 占据 1 个网格格子。通过GridLayoutManager.SpanSizeLookup可以实现单个 item 占据多个格子的效果，例如表头占满整行、特殊 item 占 2 列等。

使用流程

1. 自定义SpanSizeLookup子类，实现getSpanSize(int position)方法
2. 在该方法中根据 item 位置返回占据的格子数
3. 调用layoutManager.setSpanSizeLookup()设置自定义实现
4. 调用RecyclerView.Adapter的notifyDataSetChanged()刷新 UI

示例：实现复杂网格布局

需求：第一个 item 占 4 格（整行），第二个和第三个 item 各占 2 格，其余 item 占 1 格

layoutManager.setSpanSizeLookup(new GridLayoutManager.SpanSizeLookup() {
    @Override
    public int getSpanSize(int position) {
        if (position == 0) {
            return 4; // 第一个item占4格
        } else if (position == 1 || position == 2) {
            return 2; // 第二个、第三个item各占2格
        }
        return 1; // 其他item占1格
    }
});
// 刷新UI
adapter.notifyDataSetChanged();

---

二、RecyclerView 数据更新：高效 notify 方法

当网格布局的数据发生变化时，需要通过RecyclerView.Adapter提供的 notify 系列方法通知 UI 更新。不同的方法对应不同的场景，合理使用能优化性能和动画效果。

常用 notify 方法对比

方法	作用	适用场景
notifyItemChanged(int position)	通知指定位置 item 数据变化	单个 item 数据更新
notifyItemInserted(int position)	通知指定位置插入新 item	单个 item 插入
notifyItemRemoved(int position)	通知指定位置移除 item	单个 item 删除
notifyItemMoved(int fromPos, int toPos)	通知 item 从 fromPos 移动到 toPos	拖拽排序后位置更新
notifyDataSetChanged()	通知数据集整体变化	全量数据刷新（效率最低）
notifyItemRangeChanged(int start, int count)	通知从 start 开始的 count 个 item 变化	连续多个 item 更新
notifyItemRangeInserted(int start, int count)	通知从 start 开始插入 count 个 item	批量插入连续 item
notifyItemRangeRemoved(int start, int count)	通知从 start 开始移除 count 个 item	批量删除连续 item

注意：拖拽和侧滑操作后，建议使用针对性的 notify 方法（如notifyItemMoved、notifyItemRemoved），而非notifyDataSetChanged，以保留默认动画效果。

---

三、ItemTouchHelper：实现拖拽排序与侧滑删除

ItemTouchHelper 是 Android 官方提供的 RecyclerView 交互辅助类，无需手动处理触摸事件和动画，就能快速实现拖拽（Drag and Drop）和侧滑删除（Swipe to Dismiss）功能。

1. 核心特点

• 支持自定义拖拽和侧滑方向
• 提供回调接口，便于处理数据更新
• 内置流畅动画，无需额外实现
• 集成简单，仅需几行代码关联 RecyclerView

2. 使用步骤

步骤 1：创建 ItemTouchHelper.Callback 子类

Callback是 ItemTouchHelper 的核心接口，需要重写关键方法定义交互行为：

public class MyItemTouchHelperCallback extends ItemTouchHelper.Callback {

    private final RecyclerView.Adapter mAdapter;
    private final List<?> mDataList;

    // 构造方法传入Adapter和数据源，用于更新数据
    public MyItemTouchHelperCallback(RecyclerView.Adapter adapter, List<?> dataList) {
        this.mAdapter = adapter;
        this.mDataList = dataList;
    }

    // 定义拖拽和侧滑支持的方向
    @Override
    public int getMovementFlags(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
        // 拖拽方向：上下
        int dragFlags = ItemTouchHelper.UP | ItemTouchHelper.DOWN;
        // 侧滑方向：左右
        int swipeFlags = ItemTouchHelper.START | ItemTouchHelper.END;
        // 组合flags并返回
        return makeMovementFlags(dragFlags, swipeFlags);
    }

    // 拖拽时回调：更新数据源
    @Override
    public boolean onMove(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, RecyclerView.ViewHolder target) {
        int fromPos = viewHolder.getAdapterPosition();
        int toPos = target.getAdapterPosition();
        // 交换数据源中对应的元素
        Collections.swap(mDataList, fromPos, toPos);
        // 通知Adapter数据位置变化
        mAdapter.notifyItemMoved(fromPos, toPos);
        return true;
    }

    // 侧滑时回调：删除数据
    @Override
    public void onSwiped(RecyclerView.ViewHolder viewHolder, int direction) {
        int position = viewHolder.getAdapterPosition();
        // 从数据源中移除元素
        mDataList.remove(position);
        // 通知Adapter数据移除
        mAdapter.notifyItemRemoved(position);
    }

    // 可选：自定义交互动画或样式
    @Override
    public void onChildDraw(Canvas c, RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder, float dx, float dy, int actionState, boolean isCurrentlyActive) {
        super.onChildDraw(c, recyclerView, viewHolder, dx, dy, actionState, isCurrentlyActive);
        // 此处可实现自定义拖拽/侧滑动画，如改变item透明度、绘制删除图标等
    }

    // 可选：恢复item初始状态
    @Override
    public void clearView(RecyclerView recyclerView, RecyclerView.ViewHolder viewHolder) {
        super.clearView(recyclerView, viewHolder);
        // 操作结束后恢复item状态，避免复用导致显示错乱
        viewHolder.itemView.setAlpha(1.0f);
    }
}

步骤 2：关联 RecyclerView

在 Activity/Fragment 中初始化 ItemTouchHelper 并关联 RecyclerView：

// 初始化数据源（示例：水浒人物列表）
List<String> dataList = new ArrayList<>(Arrays.asList(
    "宋江", "卢俊义", "吴用", "公孙胜", "关胜", "林冲", ...
));

// 初始化Adapter和RecyclerView
MyAdapter adapter = new MyAdapter(dataList);
RecyclerView recyclerView = findViewById(R.id.recycler_view);

// 设置GridLayoutManager
GridLayoutManager layoutManager = new GridLayoutManager(this, 4);
recyclerView.setLayoutManager(layoutManager);
recyclerView.setAdapter(adapter);

// 初始化ItemTouchHelper并关联RecyclerView
ItemTouchHelper.Callback callback = new MyItemTouchHelperCallback(adapter, dataList);
ItemTouchHelper itemTouchHelper = new ItemTouchHelper(callback);
itemTouchHelper.attachToRecyclerView(recyclerView);

3. Callback 核心方法说明

方法	作用
getMovementFlags	定义拖拽（dragFlags）和侧滑（swipeFlags）支持的方向
onMove	拖拽结束时回调，需更新数据源并通知 Adapter
onSwiped	侧滑结束时回调，需删除数据源元素并通知 Adapter
onChildDraw	绘制自定义交互效果（如侧滑删除图标、拖拽动画）
clearView	操作结束后恢复 item 初始状态，避免复用问题
onSelectedChanged	item 从静止变为拖拽 / 侧滑状态时回调，可设置选中样式

---

四、常见问题与优化建议

1. 网格布局 item 显示错乱

• 原因：item 复用导致的状态残留
• 解决方案：在clearView方法中恢复 item 初始状态（如透明度、背景色），Adapter 的onBindViewHolder中正确重置数据

2. 拖拽 / 侧滑无动画效果

• 原因：使用了notifyDataSetChanged而非针对性的 notify 方法
• 解决方案：拖拽后用notifyItemMoved，侧滑后用notifyItemRemoved，批量操作使用 range 系列方法

3. 复杂网格布局计算错误

• 原因：spanCount（列数 / 行数）与getSpanSize返回值不匹配
• 解决方案：确保所有 item 的getSpanSize返回值之和能被spanCount整除（垂直滚动时）

4. 性能优化

• 避免在onMove、onSwiped中执行耗时操作
• 大数据量时使用DiffUtil计算数据差异，替代全量刷新
• 自定义onChildDraw时避免创建大量临时对象，减少内存开销

---

五、总结

GridLayoutManager 为 RecyclerView 提供了强大的网格布局能力，通过SpanSizeLookup可轻松实现不规则网格排列；而 ItemTouchHelper 则简化了拖拽排序和侧滑删除功能的开发，无需关注底层触摸事件和动画实现。两者结合能极大提升 RecyclerView 的交互体验，适用于电商商品列表、相册网格、任务管理等多种场景。