自定義LayoutManager簡明教程

自定義LayoutManager的步驟:

總體可分為四步:

  1. 重寫generateDefaultLayoutParams()
  2. 重寫 onLayoutChildren()
  3. 重寫 canScrollVertically() 或者 canScrollHorizontally()
  4. 重寫 scrollHorizontallyBy() 或者 scrollVerticallyBy()

這些都是些什么。別慌,一步步來,下面會以可橫向滾動layoutManager來一一解釋這些方法。首先得注意無論是在onLayoutChildren、scrollHorizontallyBy() 或者 scrollVerticallyBy()RecyclerView只會layout出可見的childview,不可見的childView會被移除、回收掉

步驟1
  • 方法解釋
    generateDefaultLayoutParams():為RecyclerView的子View(也就是我們常說的Itme)創建一個默認的LayoutParams對象

    SDK 解釋如下
    Create a default LayoutParams object for a child of the RecyclerView.

  • 實現,沒有特殊要求如下實現方式即可

@Override
    public RecyclerView.LayoutParams generateDefaultLayoutParams() {
        return new RecyclerView.LayoutParams(
                RecyclerView.LayoutParams.WRAP_CONTENT,
                RecyclerView.LayoutParams.WRAP_CONTENT);
    }
步驟2
  • 方法解釋
    onLayoutChildren():從給定適配器設置所有相關的子視圖.在初始化或者調用notifyDataSetChanged()時調用該方法,只需要layout 顯示的childView即可

    SDK 解釋如下
    Lay out all relevant child views from the given adapter

  • 實現

  1. 常量、變量解釋
 //RecyclerView從右往左滑動時,新出現的child添加在右邊
    private static int ADD_RIGHT = 1;
    //RecyclerView從左往右滑動時,新出現的child添加在左邊
    private static int ADD_LEFT = -1;
    //SDK中的方法,幫助我們計算一些layout childView 所需的值,詳情看源碼,解釋的很明白
    private OrientationHelper helper;
    //動用 scrollToPosition 后保存去到childView的位置,然后重新布局即調用onLayoutChildren
    private int mPendingScrollPosition = 0;
  1. onLayoutChildren 實現
    public void onLayoutChildren(RecyclerView.Recycler recycler, RecyclerView.State state) {
        if (getItemCount() == 0) {
            detachAndScrapAttachedViews(recycler);
            return;
        }
        if (getChildCount() == 0 && state.isPreLayout()) {
            return;
        }
        //初始化OrientationHelper
        ensureStatus();
        int offset = 0;
        //計算RecyclerView 可用布局寬度  具體實現 mLayoutManager.getWidth() - mLayoutManager.getPaddingLeft()
        //- mLayoutManager.getPaddingRight();
        int mAvailable = helper.getTotalSpace();
        //調用notifyDataSetChanged 才有 getChildCount() != 0
        if (getChildCount() != 0) {
            //得到第一個可見的childView
            View firstView = getChildAt(0);
            //得到第一個可見childView左邊的位置
            offset = helper.getDecoratedStart(firstView);
            //獲取第一個可見childView在Adapter中的position(位置)
            mPendingScrollPosition = getPosition(firstView);
            //offset的值為負數,在可見區域的左邊,那么當重新布局事得考慮正偏移
            mAvailable += Math.abs(offset);
        }
        //移除所有的view,
        detachAndScrapAttachedViews(recycler);
        //將可見區域的childView layout出來
        layoutScrap(recycler, state, offset, mAvailable);
    }
  1. 初始化OrientationHelper
private void ensureStatus() {
        if (helper == null) {
            helper = OrientationHelper.createHorizontalHelper(this);
        }
    }
  1. 將可見區域的childView layout出來
/**
     * 將可見區域的childView layout出來
     */
    private void layoutScrap(RecyclerView.Recycler recycler, RecyclerView.State state, int offset, int mAvailable) {
        for (int i = mPendingScrollPosition; i < state.getItemCount(); i++) {
            //可用布局寬度不足,跳出循環
            if (mAvailable <= 0) {
                break;
            }
            //在右邊添加新的childView
            int childWidth = layoutScrapRight(recycler, i, offset);
            mAvailable -= childWidth;
            offset += childWidth;
        }
    }
  1. 添加新的childView
 /**
     *  RecyclerView從右往左滑動時,新出現的child添加在右邊
     */
    private int layoutScrapRight(RecyclerView.Recycler recycler, int position, int offset) {
        return layoutScrap(recycler, position, offset, ADD_RIGHT);
    }

    /**
     *  RecyclerView從右往左滑動時,新出現的child添加在右邊
     */
    private int layoutScrapleft(RecyclerView.Recycler recycler, int position, int offset) {
        return layoutScrap(recycler, position, offset, ADD_LEFT);
    }

    /**
     *  RecyclerView從右往左滑動時,添加新的child
     */
    private int layoutScrap(RecyclerView.Recycler recycler, int position, int offset, int direction) {
        //從 recycler 中取到將要出現的childView
        View childPosition = recycler.getViewForPosition(position);
        if (direction == ADD_RIGHT) {
            addView(childPosition);
        } else {
            addView(childPosition, 0);
        }
        //計算childView的大小
        measureChildWithMargins(childPosition, 0, 0);
        int childWidth = getDecoratedMeasuredWidth(childPosition);
        int childHeigth = getDecoratedMeasuredHeight(childPosition);
        if (direction == ADD_RIGHT) {
            //layout childView
            layoutDecorated(childPosition, offset, 0, offset + childWidth, childHeigth);
        } else {
            layoutDecorated(childPosition, offset - childWidth, 0, offset, childHeigth);
        }
        return childWidth;
    }
步驟3
  • 方法解釋
    canScrollVertically():豎直方向是否可以滾動
    canScrollHorizontally():水平方向是否可以滾動

  • 實現 ,本例只實現canScrollHorizontally

@Override
    public boolean canScrollHorizontally() {
        return true;
    }
步驟4
  • 方法解釋
    scrollVerticallyBy():處理豎直方向滾動時不可見的childView的回收,新出現childview的添加
    scrollHorizontallyBy():處理水平方向滾動時不可見的childView的回,收新出現childview的添加

  • 實現 ,本例只實現scrollHorizontallyBy

 @Override
    public int scrollHorizontallyBy(int dx, RecyclerView.Recycler recycler, RecyclerView.State state) {
        //回收不可見的childview
        recylerUnVisiableView(recycler, dx);
        //將新出現的childview layout 出來
        int willScroll = fillChild(recycler, dx, state);
        //水平方向移動childview
        offsetChildrenHorizontal(-willScroll);
        return willScroll;
    }

    private int fillChild(RecyclerView.Recycler recycler, int dx, RecyclerView.State state) {
        if (dx > 0) {//RecyclerView從右往左滑動時
            //得到最后一個可見childview
            View lastView = getChildAt(getChildCount() - 1);
            //得到將顯示的childView 在adapter 中的position
            int position = getPosition(lastView) + 1;
            //得到最后一個可見childView右邊的偏移
            int offset = helper.getDecoratedEnd(lastView);
            //判斷是否有足夠的空間
            if (offset - dx < getWidth() - getPaddingRight()) {
                //item 足夠
                if (position < state.getItemCount()) {
                    layoutScrapRight(recycler, position, offset);
                } else {
                    //item 不足 返回新的可滾動的寬度    
                    return offset - getWidth() + getPaddingRight();
                }
            }
        } else {//RecyclerView從左往右滑動時
            //得到第一個可見childview
            View firstView = getChildAt(0);
            //得到將顯示的childView 在adapter 中的position
            int position = getPosition(firstView) - 1;
            //得到第一個可見childView左邊的偏移
            int offset = helper.getDecoratedStart(firstView);
            //判斷是否有足夠的空間
            if (offset - dx > getPaddingLeft()) {
                //item 足夠
                if (position >= 0) {
                    layoutScrapleft(recycler, position, offset);
                } else {
                    //item 不足 返回新的可滾動的寬度  
                    return offset - getPaddingLeft();
                }
            }
        }
        return dx;
    }

    /**
     * 回收不可見的childview
     */
    private void recylerUnVisiableView(RecyclerView.Recycler recycler, int dx) {
        for (int i = 0; i < getChildCount(); i++) {
            View child = getChildAt(i);
            if (dx > 0) {//RecyclerView從右往左滑動時
                //將左邊消失的childView 回收掉
                if (helper.getDecoratedEnd(child) - dx < getPaddingLeft()) {
                    removeAndRecycleView(child, recycler);
                    break;
                }
            } else {//RecyclerView從左往右滑動時
                //將右邊的childView 回收掉
                if (helper.getDecoratedStart(child) - dx > getWidth() - getPaddingRight()) {
                    removeAndRecycleView(child, recycler);
                    break;
                }
            }
        }
    }
擴展
  • scrollToPosition 滑動到指定位置,調用該方法后,會調用onLayoutChildren
@Override
    public void scrollToPosition(int position) {
        super.scrollToPosition(position);
        mPendingScrollPosition = position;
        requestLayout();
    }
  • smoothScrollToPosition 緩慢的滾動到指定位置
 @Override
    public void smoothScrollToPosition(RecyclerView recyclerView, RecyclerView.State state, int position) {
        LinearSmoothScroller linearSmoothScroller =
                new LinearSmoothScroller(recyclerView.getContext()) {
                    @Nullable
                    @Override
                    public PointF computeScrollVectorForPosition(int targetPosition) {
                        if (getChildCount() == 0) {
                            return null;
                        }
                        final int firstChildPos = getPosition(getChildAt(0));
                        final int direction = targetPosition < firstChildPos ? -1 : 1;
                        return new PointF(direction, 0);
                    }
                };
        linearSmoothScroller.setTargetPosition(position);
        startSmoothScroll(linearSmoothScroller);
    }
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,791評論 6 545
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,795評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,943評論 0 384
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 64,057評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,773評論 6 414
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,106評論 1 330
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,082評論 3 450
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,282評論 0 291
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,793評論 1 338
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,507評論 3 361
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,741評論 1 375
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,220評論 5 365
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,929評論 3 351
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,325評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,661評論 1 296
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,482評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,702評論 2 380

推薦閱讀更多精彩內容

  • 簡介: 提供一個讓有限的窗口變成一個大數據集的靈活視圖。 術語表: Adapter:RecyclerView的子類...
    酷泡泡閱讀 5,202評論 0 16
  • 背景 一年多以前我在知乎上答了有關LeetCode的問題, 分享了一些自己做題目的經驗。 張土汪:刷leetcod...
    土汪閱讀 12,765評論 0 33
  • ViewDragHelper實例的創建 ViewDragHelper重載了兩個create()靜態方法public...
    傀儡世界閱讀 671評論 0 3
  • 這篇文章分三個部分,簡單跟大家講一下 RecyclerView 的常用方法與奇葩用法;工作原理與ListView比...
    LucasAdam閱讀 4,413評論 0 27
  • 自我的解析 是了解孤獨的第一步 當你沉淀了一段感情 四下無人的夜里 終會釋放 此時孤獨被你提起 此時孤獨需要你的陪...
    樸質的騷話閱讀 220評論 0 1