ELinkageScroll核心原理之一:NestedScroll父子滚动消费规则深度剖析

原创2026-10-18 12:20:461,974 阅读

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 的“能不能滚、能滚多少、内容滚到哪了”拥有完全知情权,为消费决策提供了数据基础。

三、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

业务接入时,照搬仓库既有模式即可:

  1. 可滚动子 view:参考 view/ 目录下的 LScrollView、LRecyclerView、LWebView,实现 ILinkageScroll,提供完整 LinkageScrollHandler,并在滚动回调中上报到顶/到底事件
  2. 不可滚动子 view:参考 LTextView、LLinearLayout,基于 LinkageScrollHandlerAdapter 将 isScrollable() 置为 false
  3. XML 声明:所有子 view 直接放在 ELinkageScrollLayout 之下

另外注意 isTargetScrollable 中的“高度校验”:子 view 即使声称可滚动,只要高度小于容器高度就按不可滚动处理,避免“内容不够一屏却参与联动”的尴尬体验。

七、总结:NestedScroll 消费规则三个记忆点

  • Pre 阶段管“边界”:onNestedPreScroll 以 scrollY 与子 view 顶边的关系决定优先级——越过边界的路由父容器走满,站在边界上时让位于子 view
  • 常规阶段管“剩余”:onNestedScroll 只消费子 view 没吃完的距离,完成同帧移交
  • Fling 阶段管“接力”:onNestedPreFling 定发起者,ChildLinkageEvent + 速度跟踪完成父子互接力的闭环

理解这三组规则,你就能在任何嵌套滚动容器中复现类似的联动滚动能力。

登录后查看全文
ELinkageScroll