簡單實現(xiàn)內(nèi)嵌上拉刷新、下拉加載的RecyclerView布局

RecyclerView出現(xiàn)之前,大家基本都是使用的ListView,通過ListView自帶的api能輕松的實現(xiàn)頭布局和尾布局的添加,但RecyclerView并不具備這樣的API,所以coding今天決定簡單實現(xiàn)一個帶上拉加載、下拉刷新的布局。
如果你不想聽我瞎逼逼,可點擊該鏈接https://github.com/stray-coding/SwipeLayout.直接查看源碼即可!

第一步:自定義SwipeLayout作為容器

首先我們先剖析一個需要實現(xiàn)的布局,不出意外應(yīng)該是下面這個樣子:



根據(jù)上圖可知:上拉加載和下拉刷新,正常情況下用戶是看不到的,只有用戶在滑動手機屏幕的過程中,到達了RecyclerView的頂部/底部時才會顯示相應(yīng)的視圖。所以我們先自定義SwipeLayout類,繼承LinearLayout布局,然后添加headerView、recyclerView、footerView三個布局,并且其中子布局的RecyclerView的高度應(yīng)該與ViewGroup保持一致。

class SwipeLayout(ctx: Context, attr: AttributeSet) : LinearLayout(ctx, attr) {
    /**
     * 作為數(shù)據(jù)加載的RecyclerView
     * */
    var contentRv = RecyclerView(ctx)       
    var headerView: View = View.inflate(context, getId(context, "layout", "swipe_header_view"), null)
    var footerView: View = View.inflate(context, getId(context, "layout", "swipe_footer_view"), null)
            gravity = Gravity.CENTER
        orientation = VERTICAL
        contentRv.overScrollMode = RecyclerView.OVER_SCROLL_NEVER
        /**
         * 延遲初始化View,是為了獲取整個ViewGroup的高度,從而式RecyclerView的高度與ViewGroup保持一致
         * */
        post {
            layoutHeight = height
            layoutWidth = width
            Log.d(TAG, "width:$layoutWidth height:$layoutHeight")
            addView(headerView, LayoutParams(LayoutParams.MATCH_PARENT, HEADER_HEIGHT))
            addView(contentRv, LayoutParams(LayoutParams.MATCH_PARENT, layoutHeight))
            addView(footerView, LayoutParams(LayoutParams.MATCH_PARENT, FOOTER_HEIGHT))
        }
}

第二步:讓SwipeLayout動起來

在添加完布局后,總所周知,LinearLayout是不具備ScrollView的屬性的(即:內(nèi)容會根據(jù)手指的移動而滑動),所以我們就需要讓SwipeLayout動起來,這就涉及到對SwipeLayout內(nèi)部的Event事件進行處理。
我們先來捋一捋SwipeLayout什么時候需要滑動,是不是當(dāng)其內(nèi)部的RecyclerView的內(nèi)容到達頂部或者底部的時候,用戶如果繼續(xù)滑動,我們就時候就需要給用戶呈現(xiàn)上拉加載/下拉刷新的視圖。然后當(dāng)滑動繼續(xù)回歸到RecylerView視圖中,則又需要將事件交由RecyclerView處理。
經(jīng)過上面的分析,我們實際上只需要在SwipeLayout的dispatchTouchEvent方法中進行處理即可,在Move事件中判斷RecyclerView是否已經(jīng)到達了頂部或者底部,如果達到則SwipeLayout自己處理,做上拉下載/下拉刷新的視圖操作,反之則留給RecyclerView自己處理。

    override fun dispatchTouchEvent(ev: MotionEvent?): Boolean {
        Log.d(TAG, "dispatchTouchEvent: y:${ev!!.y.toInt()}")
        when (ev.action) {
            MotionEvent.ACTION_DOWN -> {
                downY = ev.y
                lastY = ev.y
                Log.d(TAG, "downY:$downY")
            }
            MotionEvent.ACTION_MOVE -> {
                rvIsArriveTop = isArriveTop(contentRv)
                rvIsArriveDown = isArriveBottom(contentRv)
                if (!isLoadData) {
                    scrollLayout(ev.y)
                }
                lastY = ev.y
            }
        return super.dispatchTouchEvent(ev)
    }
    
    private fun scrollLayout(moveY: Float) {
        val nextScrollY = scrollY + lastY - moveY
        Log.d(TAG, "nextScrollY:${nextScrollY} currScrollX:$scrollX")
        if (rvIsArriveTop) {
            pullDownScroll(nextScrollY)
        } else if (rvIsArriveDown) {
            pullUpScroll(nextScrollY)
        }
    }
    
    /**
     * 下拉刷新
     * 正常的scrollY的值應(yīng)該在 -MAX_SCROLL_DISTANCE ~ 0之間
     * 超過0則按0處理
     * 低于-MAX_SCROLL_DISTANCE 按 -MAX_SCROLL_DISTANCE處理
     * */
    private fun pullDownScroll(nextScrollY: Float) {
        if (!isHeaderViewEnable) return
        when {
            nextScrollY >= 0 -> {
                scrollTo(0, 0)
            }
            nextScrollY < -MAX_SCROLL_DISTANCE -> {
                scrollTo(0, -MAX_SCROLL_DISTANCE)
            }
            else -> {
                scrollTo(0, nextScrollY.toInt())
            }
        }
    }

    /**
     * 上拉加載
     * 正常的scrollY的值應(yīng)該在 0 ~ MAX_SCROLL_DISTANCE之間
     * 低于0則按0處理
     * 超過MAX_SCROLL_DISTANCE 按MAX_SCROLL_DISTANCE處理
     * */
    private fun pullUpScroll(nextScrollY: Float) {
        if (!isFooterViewEnable) return
        when {
            nextScrollY < 0 -> {
                scrollTo(0, 0)
            }
            nextScrollY > MAX_SCROLL_DISTANCE -> {
                scrollTo(0, MAX_SCROLL_DISTANCE)
            }
            else -> {
                scrollTo(0, nextScrollY.toInt())
            }
        }
    }    

第三步:讓下拉刷新/上拉加載能自動回彈到頂部/頂部

當(dāng)用戶松開手指時,我們會判斷用戶的滑動距離,是否足夠觸發(fā)我們的上拉加載/下拉刷新,若不足以,則需要回彈到正常的視圖界面,反之則應(yīng)該完整的顯示上拉加載/下拉刷新視圖。這里我們需要用到scrollTo的方法,但是scrollTo時瞬時完成的,這樣跟用戶的UI交互很不好,所以需要使用到Scroller來進行一個回調(diào)的動畫效果。
Scroller的使用方法大體分為三步:

  • 初始化scroller對象 private val scroller = Scroller(context)
  • 設(shè)置滑動的起點,以及需要滑動的x,y軸的距離 scroller.startScroll(x軸起點坐標(biāo), y軸起點坐標(biāo), x軸滑動距離, y軸滑動距離)
  • 重寫父類的computeScroll()方法,內(nèi)部實現(xiàn)緩慢滑動邏輯
    override fun computeScroll() {
        if (scroller.computeScrollOffset()) {
            scrollTo(0, scroller.currY)
            postInvalidate()
        }
    }

判斷是否觸發(fā)數(shù)據(jù)加載條件,以及實現(xiàn)上拉加載/下拉刷新視圖顯示與回彈

    override fun dispatchTouchEvent(ev: MotionEvent?): Boolean {
        Log.d(TAG, "dispatchTouchEvent: y:${ev!!.y.toInt()}")
        when (ev.action) {
            MotionEvent.ACTION_UP -> {
                /**
                 * 超過一半且未在加載數(shù)據(jù),則視為進行下拉刷新和上拉加載操作
                 * */
                if ((abs(scrollY) >= MAX_SCROLL_DISTANCE / 2) and !isLoadData) {
                    isLoadData = true
                    if (rvIsArriveTop) {
                        startRefresh()
                    } else if (rvIsArriveDown) {
                        startLoadMore()
                    }
                } else {
                    smoothResetScroll()
                }
            }
        }
        return super.dispatchTouchEvent(ev)
    }

第四步:定義接口,從而監(jiān)聽下拉刷新/上拉加載

定義回調(diào)接口,在合適的地方回調(diào),從而告知開發(fā)者,目前正在進行下拉刷新/上拉加載操作,需要執(zhí)行具體的業(yè)務(wù)邏輯

    interface ActionListener {
        fun onRefresh()
        fun onLoadMore()
    }

最終效果:

詳細代碼地址:https://github.com/stray-coding/SwipeLayout.

  • startLoadMore() 主動執(zhí)行上拉加載
  • startRefresh() 主動執(zhí)行下拉刷新
  • smoothResetScroll() 隱藏上拉加載 or 下拉刷新 的視圖
  • contentRv 獲取到內(nèi)部的RecyclerView對象
  • headerView 獲取/設(shè)置 headerView對象
  • footerView 獲取/設(shè)置 footerView對象
  • isHeaderViewEnable 是否啟用下拉刷新
  • isFooterViewEnable 是否啟用上拉加載

好啦,上面就是如何自定義內(nèi)嵌上拉刷新/下拉加載和RecyclerView布局的全部流程,如果你覺得對你有幫助,不要忘記在github幫我點個star哦!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容