ELinkageScroll核心原理之一:NestedScroll父子滚动消费规则深度剖析
ELinkageScroll核心原理之一:NestedScroll父子滚动消费规则深度剖析
ELinkageScroll 是一款面向 Android 的多子 view 嵌套滚动通用解决方案,能让 WebView、RecyclerView、ScrollView 等多个可滚动子 view 在同一个容器内按顺序流畅滚动。其体验的关键,在于 NestedScroll(嵌套滚动)机制下父容器与子 view 之间“谁该消费这段滚动距离”的决策规则。本文以核心容器 ELinkageScrollLayout 为例,深度剖析完整的父子滚动消费规则。
一、为什么多子 view 嵌套滚动很难
把多个同方向可滚动的 view 放进一个容器,通常会遇到三类问题:
- 滚动阻塞:子 view 接管手势后,父容器“滚不动”了
- 滚动跳变:跨越子 view 边界时滚动位置出现断层
- 惯性丢失:子 view 惯性滚动到顶/到底后戛然而止,无法带动下一个 view
问题本质是:一帧手势产生的滚动距离只能被消费一次,父 view 与子 view 之间必须建立清晰的消费契约。这正是 Android 的 NestedScrollingParent / NestedScrollingChild 机制要解决的问题。
ELinkageScrollLayout 直接 extends ViewGroup implements NestedScrollingParent,并在 onStartNestedScroll 中只接受垂直方向(SCROLL_AXIS_VERTICAL)的嵌套滚动——即消费契约只在纵向生效。
二、建立父子契约的 3 个核心接口
理解消费规则前,先认识父容器如何“了解”每一个子 view。ELinkageScroll 用 3 个接口构成完整契约:
| 接口 | 职责 | 对应文件 |
|---|---|---|
| ILinkageScroll | 子 view 强制接口:提供滚动处理器、注册事件回调 | ILinkageScroll.java |
| LinkageScrollHandler | 滚动能力描述器:canScrollVertically、flingContent、scrollContentToTop 等 |
LinkageScrollHandler.java |
| ChildLinkageEvent | 子 view → 父容器事件回调,上报“内容滚动到顶/到底”等关键时刻 | ChildLinkageEvent.java |
几个关键约定:
- 容器内所有子 view 必须实现 ILinkageScroll,否则在 onFinishInflate 中直接抛出运行时异常
- 不可滚动子 view(LTextView、LLinearLayout)只需继承缺省适配器 LinkageScrollHandlerAdapter,并让
isScrollable()返回false - 可滚动子 view(LScrollView、LRecyclerView、LWebView)则实现完整的 LinkageScrollHandler
这套分工让父容器对每个子 view 的“能不能滚、能滚多少、内容滚到哪了”拥有完全知情权,为消费决策提供了数据基础。
三、onNestedPreScroll 深度剖析:父容器的优先消费规则
每帧滚动距离的第一站是 onNestedPreScroll,这是 ELinkageScroll 判定消费优先级的核心,完整逻辑见 onNestedPreScroll。
它的关键动作,是把容器当前滚动位置 scrollY 与手指触摸所在子 view 的顶部边界 topEdge(布局时记录进 ViewEdge 的边界表)做比较,共 3 种状态:
场景 1:scrollY == topEdge(容器顶部与子 view 顶部齐平)
即“正好站在某个子 view 门口”:
- 手指上滑(
dy > 0):查询子 view 的canScrollVertically(1),子 view 能继续滚 → 交给子 view;不能滚 → 父容器全部消费(继续带动下一个 view) - 手指下滑(
dy < 0):查询canScrollVertically(-1),子 view 能滚回上方 → 交给子 view;不能 → 父容器全部消费(把上一个 view 拉回来)
场景 2:scrollY > topEdge(子 view 内容已部分被顶部遮住)
- 手指上滑:父容器全部消费,直到把子 view 拉回顶部(
scrollY == topEdge)后,再交由子 view 接管 - 手指下滑:父容器消费到 topEdge 为止,剩余距离交给子 view
场景 3:scrollY < topEdge(子 view 内容尚未露面)
子 view 顶部还没进入容器可视区,上方还是前一个 view 的内容:
- 手指下滑:父容器全部消费,直到把子 view 完整拉进来
- 手指上滑:父容器消费到 topEdge 为止,剩余距离交给子 view
消费规则速查表 🧭
| 容器当前状态 | 手指上滑(dy > 0) | 手指下滑(dy < 0) |
|---|---|---|
| 与子 view 顶部齐平 | 子 view 能滚 → 子消费;不能 → 父消费 | 子 view 能滚回 → 子消费;不能 → 父消费 |
| 子 view 内容已被部分遮住 | 父容器全部消费 | 父消费到子 view 顶部,剩余子 view 消费 |
| 子 view 内容尚未露面 | 父消费到子 view 顶部,剩余子 view 消费 | 父容器全部消费 |
一句话总结:跨越子 view 边界的路,必须由父容器“走满全程”;站在边界上时,优先让子 view 接管。这就是联动滚动“丝滑衔接、永不跳变”的来源。
四、onNestedScroll:子 view 的“剩余量”消费规则
当 onNestedPreScroll 返回 0 消费时,子 view 自行滚动后会回调父容器的 onNestedScroll,参数语义是:
dxConsumed / dyConsumed:子 view 已经消费的距离dxUnconsumed / dyUnconsumed:子 view 未能消费的距离
父容器的规则极简:只要子 view 消费了一部分(dyConsumed != 0)且还有剩余(dyUnconsumed != 0),父容器就用 scrollBy 把剩余距离消费掉。
这正是场景 2、场景 3 中“部分交给父容器”的落地实现——子 view 滚到顶的同一帧内,剩余距离无缝交给容器,用户看到的是一次连贯的滚动。
五、惯性滚动接力:onNestedPreFling 的完整链路
手指抬起后,消费规则延伸到了惯性阶段,这也是 ELinkageScroll 最精巧的设计,共三步:
第 1 步:决定 fling 的发起者。 onNestedPreFling 中:
- 容器与子 view 顶部齐平时:父容器不接管,仅通过
trackVelocity跟踪速度,返回false,由子 view 自己 fling - 其他情况:父容器直接接管(
parentFling),返回true
第 2 步:父容器 fling 到边界时自动移交。 scrollTo(惯性分支)每帧通过 getNextEdge 按 fling 方向找出“下一个可滚动子 view 的顶边”;一旦抵达该边界,立即中止容器 fling,把当前速度交给子 view 的 flingContent 继续滚动,同时持续 trackVelocity。
第 3 步:子 view fling 到顶/到底时自动交还。 LScrollView 等在 onScrollChanged 中检测到内容到达顶部或底部时,通过 ChildLinkageEvent 的 onContentScrollToTop / onContentScrollToBottom 上报;容器从速度跟踪器取出当前速度,中止子 view 的 fling,继续 parentFling(见 mChildLinkageEvent)。
父子两步构成一条双向接力链:
父容器 fling → 到达子 view 顶边 → 子 view 接力 fling → 子 view 到顶/到底 → 父容器接力 fling → …
速度在两个环节之间被持续跟踪与传递,因此快速甩动时能从第一个 view 一路贯冲到最后,全程无断点。
六、如何写出符合消费规则的联动子 view
业务接入时,照搬仓库既有模式即可:
- 可滚动子 view:参考 view/ 目录下的 LScrollView、LRecyclerView、LWebView,实现 ILinkageScroll,提供完整 LinkageScrollHandler,并在滚动回调中上报到顶/到底事件
- 不可滚动子 view:参考 LTextView、LLinearLayout,基于 LinkageScrollHandlerAdapter 将
isScrollable()置为false - XML 声明:所有子 view 直接放在 ELinkageScrollLayout 之下
另外注意 isTargetScrollable 中的“高度校验”:子 view 即使声称可滚动,只要高度小于容器高度就按不可滚动处理,避免“内容不够一屏却参与联动”的尴尬体验。
七、总结:NestedScroll 消费规则三个记忆点
- Pre 阶段管“边界”:
onNestedPreScroll以scrollY与子 view 顶边的关系决定优先级——越过边界的路由父容器走满,站在边界上时让位于子 view - 常规阶段管“剩余”:
onNestedScroll只消费子 view 没吃完的距离,完成同帧移交 - Fling 阶段管“接力”:
onNestedPreFling定发起者,ChildLinkageEvent + 速度跟踪完成父子互接力的闭环
理解这三组规则,你就能在任何嵌套滚动容器中复现类似的联动滚动能力。