Android如何实现RecyclerView下拉拖拽动画及顶部进度条加载效果

核心实现逻辑说明 #

你之前用RecyclerView.OnScrollListener()没找到思路是正常的——这个接口只能监听列表自身的滚动位移，没法处理列表滚动到顶部之后、继续下拉的手势拦截和内容偏移逻辑，正确的实现方向是手势拦截+子View偏移控制，不需要修改RecyclerView本身的源码。
注意：AndroidX自带的SwipeRefreshLayout默认是加载指示器悬浮在列表上层，不会带动列表条目随手势下移，没法直接实现你要的效果，不用在这个组件上耗时间。

自定义实现步骤 #

• 手势拦截层：给RecyclerView添加RecyclerView.OnItemTouchListener，在触摸事件中判断：只有当列表已经滚动到最顶部（canScrollVertically(-1)返回false，且第一个完全可见条目position为0）、且手势是向下滑动时，才拦截后续触摸事件，记录手指移动的Y轴位移。
• 拖拽偏移效果：下拉过程中给位移加0.5~0.6的阻尼系数（避免跟手过于生硬），遍历RecyclerView当前所有可见的子条目，调用setTranslationY()给每个条目设置向下的偏移量；同时在列表顶部空出的偏移区域绘制自定义加载图标，图标状态跟下拉位移比例联动。
• 刷新与复位逻辑：当下拉位移超过预设的触发阈值（一般设为100~140dp），手指抬起时先把所有条目平滑回弹到「刚好露出顶部加载区」的位置，触发API/数据库拉取逻辑；等新数据获取完成后，先把新数据插入到Adapter数据集的头部，调用notifyItemRangeInserted(0, 新数据条数)插入新条目，再把所有条目平滑动画复位到初始位置，隐藏顶部加载视图。

不要直接给RecyclerView本身设置translationY做偏移，那样会把滚动条、ItemDecoration等列表附属元素一起下移，效果和你给出的iOS动效不一致，只偏移可见子条目即可。

核心手势拦截的代码片段参考：

recyclerView.addOnItemTouchListener(object : RecyclerView.OnItemTouchListener {
    private var startTouchY = 0f
    private val dragDamping = 0.55f
    private val refreshTriggerDistance = 120.dp
    private var isHandlingDrag = false

    override fun onInterceptTouchEvent(rv: RecyclerView, e: MotionEvent): Boolean {
        when (e.action) {
            MotionEvent.ACTION_DOWN -> {
                startTouchY = e.rawY
                isHandlingDrag = false
            }
            MotionEvent.ACTION_MOVE -> {
                val deltaY = e.rawY - startTouchY
                // 列表到顶且手势向下时拦截事件
                if (!rv.canScrollVertically(-1) && deltaY > 0) {
                    isHandlingDrag = true
                    return true
                }
            }
        }
        return false
    }

    override fun onTouchEvent(rv: RecyclerView, e: MotionEvent) {
        // 在此处实现位移计算、子View偏移、回弹动画、刷新触发逻辑
    }

    override fun onRequestDisallowInterceptTouchEvent(disallow: Boolean) {}
})

可直接复用的开源库 #

如果不想从零写手势和动画逻辑，可以直接用成熟的开源实现，侵入性很低：

• SwipeToLoadLayout：自带和你描述完全一致的类iOS下拉列表偏移效果，支持自定义下拉头部样式，兼容RecyclerView、ScrollView、WebView等绝大多数可滚动控件，只需要把下拉头部、列表控件作为它的子项布局，设置刷新回调即可接入。
• SmartRefreshLayout：目前Android端灵活性最高的下拉刷新框架，你可以通过自定义RefreshHeader实现任意下拉效果，官方扩展包也提供了现成的列表随动下拉样式，还支持越界回弹、二级刷新等扩展能力，适配全版本Android系统。

内容的提问来源于stack exchange，提问作者Vinit ...