RecyclerView 解决方案,支持 addHeaderView、addFooterView
RecyclerView 解决方案,支持 addHeaderView、addFooterView
Legacy RecyclerView 头部/脚部支持和 AndroidX 迁移示例。
简体中文 · 旧版示例 · 开发
这个项目最初是为了更方便地在 RecyclerView 中添加页眉、页脚和加载状态示例。如今，它保留了这一实现，作为一个可构建的迁移参考，并提供了一个 AndroidX 示例。
对于新项目,请使用 AndroidX 的 ConcatAdapter 来处理标题和页脚。 如果需要管理式分页,请添加 Paging。现有集成可以逐步迁移;此分支并不是旧版 Android 支持库的立即更新。
| 您的情况 | 从这里开始 |
|---|---|
| 构建新的 RecyclerView 屏幕 | 在 samplePlus 中运行 ConcatAdapter (AndroidX); 其页面不使用本库中的任何 API。 |
| 维护现有集成 | 请查看 兼容性和维护 以及 遗留使用说明。 |
| 寻找原始示例 | 请参阅 遗留使用和屏幕截图。 |
| 为 AI 代理做出贡献或与之合作 | 请阅读 CONTRIBUTING.md、架构 和 AGENTS.md。 |
| 需要 | 当前的 AndroidX 方法 |
|---|---|
| 头部 + 数据 + 底部 | ConcatAdapter(headerAdapter, dataAdapter, footerAdapter) |
| 数据行点击位置 | getBindingAdapterPosition(), 检查 NO_POSITION |
| 增量列表更新 | ListAdapter / DiffUtil |
| 管理分页和重试 UI | 分页 + PagingDataAdapter + LoadStateAdapter |
| 全宽格/错开格装饰 | 显式的占位查找/全宽布局参数 |
ConcatAdapter 负责处理适配器组合、通知偏移和视图类型隔离;它不选择布局跨度。分页迁移还需要移动数据请求和分页状态,而不仅仅是替换滚动监听器。请参阅官方的 ConcatAdapter 参考 和 分页加载状态指南。
暂无开放 Issues，或尚未同步最近议题。