产品简介
SwipeRecyclerView 这是一个基于RecyclerView的Android开发库,旨在为开发者提供一套开箱即用的列表交互解决方案。它集成了侧滑菜单、拖拽排序、滑动删除、加载更多等常用功能,解决了原生RecyclerView交互功能匮乏的痛点,适合需要快速实现复杂列表交互的Android开发者。

核心功能
- Item侧滑菜单(支持左/右)
- Item长按拖拽排序与侧滑删除
- 一键添加HeaderView/FooterView
- 自动或点击触发加载更多
- 支持分组列表的粘性头部效果
快速开始
- 在项目的build.gradle中添加SwipeRecyclerView的依赖库。
- 在XML布局文件中,将原生`RecyclerView`替换为`SwipeRecyclerView`控件。
- 在代码中通过`setSwipeMenuCreator`、`setOnItemMenuClickListener`等方法设置交互监听。
- 如需使用加载更多功能,调用`useDefaultLoadMore()`并设置`setLoadMoreListener`。
界面预览


与其他方案对比
| 对比项 | SwipeRecyclerView | 同类方案 |
|---|---|---|
| 交互功能 | 一站式提供侧滑菜单、拖拽、删除、加载更多等全套手势交互功能。 | 原生RecyclerView仅提供基础列表滚动,所有交互功能需开发者完全自行实现。 |
| 开发成本 | 封装为单一控件,用法与原生RecyclerView一致,仅需添加少量配置代码。 | 实现类似功能通常需要组合多个库或编写大量自定义触摸处理代码,复杂度高。 |
| 扩展性 | 支持自定义加载更多视图和菜单样式,并兼容AndroidX。 | 其他方案可能功能单一或扩展性较差,难以全面满足定制需求。 |
适合谁用
- 需要为Android应用实现复杂列表交互(如消息删除、任务排序)的Android开发者。
- 希望快速集成侧滑菜单、拖拽等标准手势功能,减少重复造轮子的移动端工程师。
- 开发带有分组粘性头部、Header/Footer等复杂布局的列表页面的开发者。
下载与版本
当前最新版本为 master,发布于 。支持 Windows、macOS、Linux。
⚠️ 注意:本项目仅提供源代码下载,不包含可直接运行的安装包(exe/dmg/apk 等。下载后需要自行编译构建才能使用,适合有一定开发经验的用户。如果你不熟悉编译流程,建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用,请遵守相关法律法规。
- 请尊重内容创作者版权,勿将下载内容用于商业或非法传播。
- 项目源码地址:https://github.com/yanzhenjie/SwipeRecyclerView