UI系列一Android多子view嵌套通用解决方案

38次阅读

共计 12070 个字符,预计需要花费 31 分钟才能阅读完成。

1. 多子 view 嵌套应用背景

百度 App 在 17 年的版本中实现 2 个子 view 嵌套滚动,用于 Feed 落地页 (webview 呈现文章详情 + recycle 呈现 Native 评论)。原理是在外层提供一个 UI 容器(我们称之为”联动容器”)处理 WebView 和 Recyclerview 连贯嵌套滚动。

当时的联动容器对子 view 限制比较大,仅支持 WebView 和 Recyclerview 进行联动滚动,数量也只支持 2 个子 View。

随着组件化进程的推进,为方便各业务解耦,对联动容器提出了更高的要求,需要支持任意类型、任意数量的子 view 进行联动滚动,也就是本文要阐述的多子 view 嵌套滚动通用解决方案。

先直观感受下联动容器嵌套滚动的 Demo 效果:

2. 多子 view 嵌套实现原理

同大多数自定义控件类似,联动容器也需要处理子 view 的测量、布局以及手势处理。测量和布局对联动容器的场景来说非常简单,手势处理相对复杂些。

从 demo 效果可以看出,联动容器需要处理好和子 view 嵌套滑动问题。嵌套滑动的处理方案有两种

  1. 基于 Google 的 NestedScrolling 机制实现嵌套滑动;
  2. 是由联动容器内部处理和子 view 嵌套滑动的逻辑。

百度 App 早期版本的联动容器采用的方案 2 实现的,下图为方案 2 联动容器手势处理流程:

笔者对方案 2 联动容器的实现代码做了开源,感兴趣的同学可以参考:https://github.com/baiduapp-t…。
基于 google 的 NestedScrolling 实现多子 view 嵌套能节省不少开发量,故笔者对多子 view 嵌套的实现采用方案一。

3. 核心逻辑

3.1 Google 嵌套滑动机制

Google 在 Android 5.0 推出了一套 NestedScrolling 机制,这套机制滚动打破了对之前 Android 传统的事件处理的认知,是按照逆向事件传递机制来处理嵌套滚动,事件传递可参考下图:

网上有很多关于 NestedScrolling 的文章,如果没接触过 NestedScrolling 的同学可参考下张鸿洋的这篇文章:https://blog.csdn.net/lmj6235…

3.2 接口设计

为了保证联动容器中子 view 的任意性,联动容器需提供完善的接口抽象供子 view 去实现。下图为联动容器暴露的接口类图:

ILinkageScroll 是置于联动容器中的子 view 必须要实现的接口,联动容器在初始化时如果发现某个子 view 没实现该接口,会抛出异常。

ILinkageScroll 中又会涉及两个接口:LinkageScrollHandler、ChildLinkageEvent。

LinkageScrollHandler 接口中的方法联动容器会在需要时主动调用,以通知子 view 完成一些功能,比如:获取子 view 是否可滚动,获取子 view 滚动条相关数据等。

ChildLinkageEvent 接口定义了子 view 的一些事件信息,比如子 view 的内容滚动到顶部或底部。当发生这些事件后,子 view 主动调用对应方法,这样联动容器收到子 view 一些事件后会做出相应的反应,保证正常的联动效果。

上面仅简单说明了下接口功能,想更加深入了解的同学请参考:https://github.com/baiduapp-t…

接下来我们详细分析下联动容器对手势处理细节,根据手势类型,将嵌套滑动分为两种情况来分析:1. scroll 手势;2. fling 手势;

3.3 scroll 手势

先给出 scroll 手势处理的核心代码:

public class ELinkageScrollLayout extends ViewGroup implements NestedScrollingParent {
    @Override
    public void onNestedPreScroll(View target, int dx, int dy, int[] consumed) {
        boolean moveUp = dy > 0;
        boolean moveDown = !moveUp;
        int scrollY = getScrollY();
        int topEdge = target.getTop();
        LinkageScrollHandler targetScrollHandler
                = ((ILinkageScroll)target).provideScrollHandler();
        if (scrollY == topEdge) {    // 联动容器 scrollY 与当前子 view 的 top 坐标重合            
            if ((moveDown && !targetScrollHandler.canScrollVertically(-1))
                    || (moveUp && !targetScrollHandler.canScrollVertically(1))) {
                // 在对应的滑动方向上,如果子 view 不能垂直滑动,则由联动容器消费滚动距离
                scrollBy(0, dy);
                consumed[1] = dy;
            } 
        } else if (scrollY > topEdge) {    // 联动容器 scrollY 大于当前子 view 的 top 坐标,也就是说,子 view 头部已经滑出联动容器
            if (moveUp) {
                // 如果手指上滑,则由联动容器消费滚动距离
                scrollBy(0, dy);
                consumed[1] = dy;
            }
            if (moveDown) {
                // 如果手指下滑,联动容器会先消费部分距离,此时联动容器的 scrollY 会不断减小,// 直到等于子 view 的 top 坐标后,剩余的滑动距离则由子 view 继续消费。int end = scrollY + dy;
                int deltaY;
                deltaY = end > topEdge ? dy : (topEdge - scrollY);
                scrollBy(0, deltaY);
                consumed[1] = deltaY;
            }
        } else if (scrollY < topEdge) {    // 联动容器 scrollY 小于当前子 view 的 top 坐标,也就是说,子 view 还没有完全露出
            if (moveDown) {
                // 如果手指下滑,则由联动容器消费滚动距离
                scrollBy(0, dy);
                consumed[1] = dy;
            }
            if (moveUp) {
                // 如果手指上滑,联动容器会先消费部分距离,此时联动容器的 scrollY 会不断增大,// 直到等于子 view 的 top 坐标后,剩余的滑动距离则由子 view 继续消费。int end = scrollY + dy;
                int deltaY;
                deltaY = end < topEdge ? dy : (topEdge - scrollY);
                scrollBy(0, deltaY);
                consumed[1] = deltaY;
            }
        }
    }
    @Override
    public void scrollBy(int x, int y) {
        // 边界检查
        int scrollY = getScrollY();
        int deltaY;
        if (y < 0) {deltaY = (scrollY + y) < 0 ? (-scrollY) : y;
        } else {deltaY = (scrollY + y) > mScrollRange ?
                    (mScrollRange - scrollY) : y;
        }
        if (deltaY != 0) {super.scrollBy(x, deltaY);
        }
    }
}

onNestedPreScroll() 回调是 google 嵌套滑动机制 NestedScrollingParent 接口中的方法。当子 view 滚动时,会先通过此方法询问父 view 是否消费这段滚动距离,父 view 根据自身情况决定是否消费以及消费多少,并将消费的距离放入数组 consumed 中,子 view 再根据数组中的内容决定自己的滚动距离。

代码注释比较详细,这里整体再做个解释:通过对子 view 的上边沿阈值和联动容器的 scrollY 进行比较,处理了 3 种 case 下的滚动情况。

第 10 行,当 scrollY == topEdge 时,只要子 view 没有滚动到顶或者底,都由子 view 正常消费滚动距离,否则由联动容器消费滚动距离,并将消费的距离通过 consumed 变量通知子 view,子 view 会根据 consumed 变量中的内容决定自己的滑动距离。

第 17 行,当 scrollY > topEdge 时,也就是说当触摸的子 view 头部已经滑出联动容器,此时如果手指向上滑动,滑动距离全部由联动容器消费,如果手指向下滑动,联动容器会先消费部分距离,当联动容器的 scrollY 达到 topEdge 后,剩余的滑动距离由子 view 继续消费。

第 32 行,当 scrollY < topEdge 这个和上一个第 17 行判断类似,这里不做过多解释。scroll 手势处理流程图如下:

3.4 fling 手势

联动容器对 fling 手势的处理大致思路如下:如果联动容器的 scrollY 等于子 view 的 top 坐标,则由子 view 自身处理 fling 手势,否则由联动容器处理 fling 手势。

而且在一次完整的 fling 周期中,联动容器和各子 view 将会交替去完成滑动行为,直到速度降为 0,联动容器需要处理好交替滑动时的速度衔接,保证整个 fling 的流畅行。接下来看下详细实现:

public class ELinkageScrollLayout extends ViewGroup implements NestedScrollingParent {
    @Override
    public boolean onNestedPreFling(View target, float velocityX, float velocityY) {int scrollY = getScrollY();
        int targetTop = target.getTop();
        mFlingOrientation = velocityY > 0 ? FLING_ORIENTATION_UP : FLING_ORIENTATION_DOWN;
        if (scrollY == targetTop) {    // 当联动容器的 scrollY 等于子 view 的 top 坐标,则由子 view 自身处理 fling 手势
            // 跟踪 velocity,当 target 滚动到顶或底,保证 parent 继续 fling
            trackVelocity(velocityY);
            return false;
        } else {    // 由联动容器消费 fling 手势
            parentFling(velocityY);
            return true;
        }
    }
}

onNestedPreFling() 回调是 google 嵌套滑动机制 NestedScrollingParent 接口中的方法。当子 view 发生 fling 行为时,会先通过此方法询问父 view 是否要消费这次 fling 手势,如果返回 true,表示父 view 要消费这次 fling 手势,反之不消费。

第 6 行根据 velocityY 正负值记录本次的 fling 的方向;

第 7 行,当联动容器 scrollY 值等于触摸子 view 的 top 值,fling 手势由子 view 处理,同时联动容器对本次 fling 手势的速度进行追踪,目的是当子 view 内容滚到顶或者底时,能够获得剩余速度以让联动容器继续 fling;

第 12 行,由联动容器消费本次 fling 手势。下面看下联动容器和子 view 交替 fling 的细节:

public class ELinkageScrollLayout extends ViewGroup implements NestedScrollingParent {
    @Override
    public void computeScroll() {if (mScroller.computeScrollOffset()) {int y = mScroller.getCurrY();
            y = y < 0 ? 0 : y;
            y = y > mScrollRange ? mScrollRange : y;
            // 获取联动容器下个滚动边界值,如果达到边界值,速度会传给下个子 view,让子 view 继续快速滑动
            int edge = getNextEdge();
            // 边界检查
            if (mFlingOrientation == FLING_ORIENTATION_UP) {y = y > edge ? edge : y;}
            // 边界检查
            if (mFlingOrientation == FLING_ORIENTATION_DOWN) {y = y < edge ? edge : y;}
            // 联动容器滚动子 view
            scrollTo(x, y);
            int scrollY = getScrollY();
            // 联动容器最新的 scrollY 是否达到了边界值
            if (scrollY == edge) {
                // 获取剩余的速度
                int velocity = (int) mScroller.getCurrVelocity();
                if (mFlingOrientation == FLING_ORIENTATION_UP) {velocity = velocity > 0? velocity : - velocity;}
                if (mFlingOrientation == FLING_ORIENTATION_DOWN) {velocity = velocity < 0? velocity : - velocity;}    
                // 获取 top 为 edge 的子 view
                View target = getTargetByEdge(edge);
                // 子 view 根据剩余的速度继续 fling
                ((ILinkageScroll) target).provideScrollHandler()
                        .flingContent(target, velocity);
                trackVelocity(velocity);
            }
            invalidate();}
    }
    /**
     * 根据 fling 的方向获取下一个滚动边界,* 内部会判断下一个子 View 是否 isScrollable,* 如果为 false,会顺延取下一个 target 的 edge。*/
    private int getNextEdge() {int scrollY = getScrollY();
        if (mFlingOrientation == FLING_ORIENTATION_UP) {for (View target : mLinkageChildren) {
                LinkageScrollHandler handler
                        = ((ILinkageScroll)target).provideScrollHandler();
                int topEdge = target.getTop();
                if (topEdge > scrollY
                        && isTargetScrollable(target)
                        && handler.canScrollVertically(1)) {return topEdge;}
            }
        } else if (mFlingOrientation == FLING_ORIENTATION_DOWN) {for (View target : mLinkageChildren) {
                LinkageScrollHandler handler
                        = ((ILinkageScroll)target).provideScrollHandler();
                int bottomEdge = target.getBottom();
                if (bottomEdge >= scrollY
                        && isTargetScrollable(target)
                        && handler.canScrollVertically(-1)) {return target.getTop();
                }
            }
        }
        return mFlingOrientation == FLING_ORIENTATION_UP ? mScrollRange : 0;
    }
    /** 
     * child view 的滚动事件 
     */
    private ChildLinkageEvent mChildLinkageEvent = new ChildLinkageEvent() {
        @Override
        public void onContentScrollToTop(View target) {
            // 子 view 内容滚动到顶部回调
            if (mVelocityScroller.computeScrollOffset()) {
                // 从速度追踪器中获取剩余速度
                float currVelocity = mVelocityScroller.getCurrVelocity();
                currVelocity = currVelocity < 0 ? currVelocity : - currVelocity;
                mVelocityScroller.abortAnimation();
                // 联动容器根据剩余速度继续 fling
                parentFling(currVelocity);
            }
        }
        @Override
        public void onContentScrollToBottom(View target) {
            // 子 view 内容滚动到底部回调
            if (mVelocityScroller.computeScrollOffset()) {
                // 从速度追踪器中获取剩余速度
                float currVelocity = mVelocityScroller.getCurrVelocity();
                currVelocity = currVelocity > 0 ? currVelocity : - currVelocity;
                mVelocityScroller.abortAnimation();
                // 联动容器根据剩余速度继续 fling
                parentFling(currVelocity);
            }
        }
    };
}

fling 的速度传递分为:

  1. 从联动容器向子 view 传递;2. 从子 view 向联动容器传递。

先看速度从联动容器向子 view 传递。核心代码在 computeScroll() 回调方法中。第 9 行,获取联动容器下一个滚动边界值,如果达到下一个滚动边界值,联动容器需要将剩余速度传给下个子 view,让其继续滚动。

第 46 行,getNextEdge() 方法内部整体逻辑:遍历所有子 view,将联动容器当前的 scrollY 与子 view 的 top/bottom 进行比较来获取下一个滑动边界。

第 34 行,当联动容器检测到滑动到下个边界时,则调用 ILinkageScroll.flingContent() 让子 view 根据剩余速度继续滚动。

再看速度从子 view 向联动容器传递,核心代码在第 76 行。当子 view 内容滚动到顶或者底,会回调 onContentScrollToTop() 方法或者 onContentScrollToBottom() 方法,联动容器收到回调后,在第 86 行和第 98 行,继续执行后续滚动。fling 手势处理流程图如下:

4. 滚动条

4.1 Android 系统的 ScrollBar

对于内容可滚动的页面,ScrollBar 则是一个不可或缺的 UI 组件,所以,ScrollBar 也是联动容器必须要实现的功能。

好在 Android 系统对滚动条的抽象非常友好,自定义控件只需要重写 View 中的几个方法,Android 系统就能帮助你正确绘制出滚动条。我们先看下 View 中的相关方法:

/**
 * <p>Compute the vertical offset of the vertical scrollbar's thumb within the horizontal range. This value is used to compute the position
 * of the thumb within the scrollbar's track.</p>
 *
 * <p>The range is expressed in arbitrary units that must be the same as the units used by {@link #computeVerticalScrollRange()} and
 * {@link #computeVerticalScrollExtent()}.</p>
 *
 * @return the vertical offset of the scrollbar's thumb
 */
protected int computeVerticalScrollOffset() {return mScrollY;}
/**
 * <p>Compute the vertical extent of the vertical scrollbar's thumb within the vertical range. This value is used to compute the length
 * of the thumb within the scrollbar's track.</p>
 *
 * <p>The range is expressed in arbitrary units that must be the same as the units used by {@link #computeVerticalScrollRange()} and
 * {@link #computeVerticalScrollOffset()}.</p>
 *
 * @return the vertical extent of the scrollbar's thumb
 */
protected int computeVerticalScrollExtent() {return getHeight();
}
/**
 * <p>Compute the vertical range that the vertical scrollbar represents.</p>
 *
 * <p>The range is expressed in arbitrary units that must be the same as the units used by {@link #computeVerticalScrollExtent()} and
 * {@link #computeVerticalScrollOffset()}.</p>
 *
 * @return the total vertical range represented by the vertical scrollbar
 */
protected int computeVerticalScrollRange() {return getHeight();
}

对于垂直 Scrollbar,我们只需要重写 computeVerticalScrollOffset(),computeVerticalScrollExtent(),computeVerticalScrollRange() 这三个方法即可。Android 对这三个方法注释已经非常详细了,这里再简单解释下:

computeVerticalScrollOffset() 表示当前页面内容滚动的偏移值,这个值是用来控制 Scrollbar 的位置。缺省值为当前页面 Y 方向上的滚动值。

computeVerticalScrollExtent() 表示滚动条的范围,也就是滚动条在垂直方向上所能触及的最大界限,这个值也会被系统用来计算滚动条的长度。缺省值是 View 的实际高度。

computeVerticalScrollRange() 表示整个页面内容可滚动的数值范围,缺省值为 View 的实际高度。

需要注意的是:offset,extent,range 三个值在单位上必须保持一致。

4.2 联动容器实现 ScrollBar

联动容器是由系统中可滚动的子 view 组成的,这些子 view(ListView、RecyclerView、WebView) 肯定都实现了 ScrollBar 功能,那么联动容器实现 ScrollBar 就非常简单了,联动容器只需拿到所有子 view 的 offset,extent,range 值,然后再根据联动容器的滑动逻辑把所有子 view 的这些值转换成联动容器对应的 offset,extent,range 即可。接口设计如下:

public interface LinkageScrollHandler {
    // ... 省略无关代码
    /**
     * get scrollbar extent value
     *
     * @return extent
     */
    int getVerticalScrollExtent();
    /**
     * get scrollbar offset value
     *
     * @return extent
     */
    int getVerticalScrollOffset();
    /**
     * get scrollbar range value
     *
     * @return extent
     */
    int getVerticalScrollRange();}

LinkageScrollHandler 接口在 3.2 小节解释过,这里不在赘述。这里面三个方法由子 view 去实现,联动容器会通过这三个方法获取子 view 与滚动条相关的值。下面看下联动容器中关于 ScrollBar 的详细逻辑:

public class ELinkageScrollLayout extends ViewGroup implements NestedScrollingParent {
    /** 构造方法 */
    public ELinkageScrollLayout(Context context, AttributeSet attrs, int defStyleAttr) {
        // ... 省略了无关代码
        // 确保联动容器调用 onDraw() 方法
        setWillNotDraw(false);
        // enable vertical scrollbar
        setVerticalScrollBarEnabled(true);
    }
    /** child view 的滚动事件 */
    private ChildLinkageEvent mChildLinkageEvent = new ChildLinkageEvent() {
        // ... 省略了无关代码
        @Override
        public void onContentScroll(View target) {
            // 收到子 view 滚动事件,显示滚动条
            awakenScrollBars();}
    }
    @Override
    protected int computeVerticalScrollExtent() {
        // 使用缺省的 extent 值
        return super.computeVerticalScrollExtent();}
    @Override
    protected int computeVerticalScrollRange() {
        int range = 0;
        // 遍历所有子 view,获取子 view 的 Range
        for (View child : mLinkageChildren) {ILinkageScroll linkageScroll = (ILinkageScroll) child;
            int childRange = linkageScroll.provideScrollHandler().getVerticalScrollRange();
            range += childRange;
        }
        return range;
    }
    @Override
    protected int computeVerticalScrollOffset() {
        int offset = 0;
        // 遍历所有子 view,获取子 view 的 offset
        for (View child : mLinkageChildren) {ILinkageScroll linkageScroll = (ILinkageScroll) child;
            int childOffset = linkageScroll.provideScrollHandler().getVerticalScrollOffset();
            offset += childOffset;
        }
        // 加上联动容器自身在 Y 方向上的滚动偏移
        offset += getScrollY();
        return offset;
    }
}

以上就是联动容器实现 ScrollBar 的核心代码,注释也非常详细,这里再重点强调几点:

系统为了提高效率,ViewGroup 默认不调用 onDraw() 方法,这样就不会走 ScrollBar 的绘制逻辑。所以在第 6 行,需要调用 setWillNotDraw(false) 打开 ViewGroup 绘制流程;

第 16 行,收到子 view 的滚动回调,调用 awakenScrollBars() 触发滚动条的绘制;

对于 extent,直接使用缺省的 extent,即联动容器的高度;

对于 range,对所有子 view 的 range 进行求和,最后得到值即为联动容器的 range;

对于 offset,同样先对所有子 view 的 offset 进行求和,之后还需要加上联动容器自身的 scrollY 值,最终得到的值即为联动容器的 offset。

大家可以返回到文章开头,再看下 Demo 中滚动条的效果,相比于市面上其它使用类似联动技术的 App,本文对滚动条的实现非常接近原生了。

5. 注意事项

联动容器执行 fling 操作时,借助 OverScroller 工具类完成的。代码如下:


private void parentFling(float velocityY) {
    // ... 省略了无关代码
    mScroller.fling(0, getScrollY(),
                0, (int) velocityY,
                0, 0,
                Integer.MIN_VALUE, Integer.MAX_VALUE);
    invalidate();}

借助 OverScroller.fling() 方法完成联动容器的 fling 行为,这段代码在小米手机上运行联动会出现问题,mScroller.getCurrVelocity() 一直是 0。

原因是小米手机 Rom 重写了 OverScroller,当 fling() 方法第三个参数传 0 时,OverScroller.mCurrVelocity 一直为 NaN,导致无法计算出正确剩余速度。

为了解决小米手机的问题,我们需要将第三个参数传个非 0 值,这里给 1 即可。

private void parentFling(float velocityY) {
    // ... 省略了无关代码
    mScroller.fling(0, getScrollY(),
                1, (int) velocityY,
                0, 0,
                Integer.MIN_VALUE, Integer.MAX_VALUE);
    invalidate();}

6. 总结

多子 view 嵌套实现原理并不复杂,对手势处理的边界条件比较琐碎,需要来回调试完善,欢迎业内的朋友一起交流学习。

Sample 地址: https://github.com/baiduapp-t…


本文作者:
zhanghao


在微信 - 搜索页面中输入“百度 App 技术”,即可关注微信官方账号;或使用微信识别以下二维码,亦可关注。

正文完
 0