企业官网建设流程全解析

ELinkageScroll是一款多子 view 嵌套滚动通用解决方案。它用一层ELinkageScrollLayout联动容器，让 WebView、RecyclerView、ScrollView、LinearLayout 等任意多个子视图在垂直方向上无缝串联滚动：父容器滚动到边界时自动把惯性交给子视图，子视图滚到顶或底时又自动交还给父容器，整个过程速度平滑、方向一致。

本文带你从零拆解它的架构：谁负责"统一滚动"，谁负责"能力上报"，谁负责"速度交接"，以及这三者如何通过一套极简接口咬合在一起。

它解决的是什么问题？

在信息流、详情页这类场景中，页面往往由多段内容纵向拼接：一段网页、一组列表、一块广告、再一段网页……

原生 Android 中，把多个可滚动 View 竖着堆叠会陷入两难：

• 各自为政：手指停在哪个 View 上就滚哪个，滚到边界后体验断档，"惯性"消失
• 强行合并：把所有内容塞进一个长 ScrollView，又会丢失 WebView、RecyclerView 的独立能力

ELinkageScroll 的思路是：滚动只有一套，归属是动态的。整个页面共享一条滚动轨道，谁"当值"就谁来消费这次滚动。

整体架构：4 个角色一张图

整个库不到 10 个类，核心是 4 个角色：

┌─────────────────────────────────────────────────┐ │ ELinkageScrollLayout（容器 / 统一滚动轨道） │ │ · 持有所有子 view 的边界表 ViewEdge │ │ · 3 个 Scroller：惯性滚动 / 定位滚动 / 速度跟踪 │ │ · 拦截手势 + 嵌套滚动协调 │ │ │ │ ┌──────────────────────────────────────────┐ │ │ │ 子 view（必须实现 ILinkageScroll） │ │ │ │ · provideScrollHandler() → Handler 能力 │ │ │ │ · 滚到顶/底时回调 ChildLinkageEvent │ │ │ └──────────────────────────────────────────┘ │ └─────────────────────────────────────────────────┘

官方内置了 5 种开箱即用的子 view，位于 view/ 目录：LWebView、LRecyclerView、LScrollView、LLinearLayout、LTextView。

ELinkageScrollLayout 容器：一条滚动轨道的三种状态

核心思想：所有子 view 平铺，容器"整体滚动"

容器在 onLayout 中把所有子 view 依次纵向排列，同时干两件关键的事：

1. 为每个子 view 记录边界ViewEdge（topEdge / bottomEdge），存入mEdgeList
2. 累加出整条轨道的可滚长度mScrollRange = Σ子view高度 - 容器高度

从此，容器就是一个"大画布"：scrollTo(0, y)时 y 是全局坐标，落在哪一段决定了当前"当家"的子 view。

三个 Scroller 各管一摊

容器内部维护了 3 个Scroller，职责划分非常清晰：

• mScroller：真正的惯性滚动引擎，驱动整条轨道的 fling
• mLocScroller：定位动画，用于gotoChild(index)平滑跳转到指定子 view
• mVelocityScroller：只用来算速度、不用于滚动——这是无缝交接的关键，后文细说

方向状态机：FLING_ORIENTATION

容器用FLING_ORIENTATION_UP / DOWN / NONE三个常量标记当前 fling 方向。这个方向标记贯穿整条链路：

• 它决定getNextEdge()从上往下还是从下往上找"下一个边界"
• 它校验子 view 事件的合法性（例如"子 view 说滚到底了"只在 DOWN 方向才作数）
• 边界检查时用它决定"惯性滚动最多推进到哪个 edge"

这种"单一方向标记 + 多处一致性校验"的设计，避免了上下滑动互相干扰的经典 bug。

LinkageScrollHandler：子 view 的"能力说明书"

LinkageScrollHandler.java 定义了一个 8 方法的接口，可以归为三组：

最后一组常被忽视却很精妙：容器重写了computeVerticalScrollOffset()，把每个子 view 的 offset 累加起来再加上自身的 scrollY。这意味着页面顶部的滚动条反映的是"整页滚动了多少"，而不是单个 View 的进度——多段内容共享一个滚动条，体验上就是一个"长页面"。

对比两种子 view 的实现就能看懂设计意图：

• 可滚动的 LRecyclerView.java：flingContent直接调fling(0, velocityY)，scrollContentToBottom直接跳到末项——把自身滚动 API 完整暴露给容器
• 不可滚动的 LTextView.java：基于 LinkageScrollHandlerAdapter（全空实现）只覆写isScrollable() = false和滚动条数据——容器会把它当成一段"固定内容"，滚过它就翻篇

LinkageScrollHandlerAdapter的存在正是为了把"接入成本"降到最低：不可滚动的子 view 几乎零代码，可滚动的子 view 只需覆写控制类方法。

联动协调：速度与位置如何"无缝交接"

这是整个架构最精彩的闭环，由两条方向相反的通道组成。

通道一：父 → 子（fling 撞边界）

手指快速下滑，容器带着整条轨道惯性滚动。当 fling 推进到某个子 view 的 topEdge（见 scrollTo 中的边界处理）：

1. 容器中止自身动画mScroller.abortAnimation()
2. 取当前速度，通过getLinkageScrollHandler(target).flingContent(target, velocity)原速驱动子 view 继续 fling
3. 同时trackVelocity(velocity)用 mVelocityScroller 记下这个速度

子 view 接手时"初速度"和父容器"末速度"完全一致，手指感觉不到任何断点。

通道二：子 → 父（子 view 滚到边界）

反过来，子 view 在自身滚动中触及顶/底时（如 LWebView 的 onScrollChanged），通过ChildLinkageEvent回调容器：

• onContentScrollToTop(target)：滚到顶了
• onContentScrollToBottom(target)：滚到底了

容器收到回调后做一串安全性校验（方向匹配、非首/末子 view、位置正好压在边界上），然后从 mVelocityScroller 里取出之前跟踪的速度，调parentFling()让整条轨道接着惯性滚动，冲向下一个子 view。

闭环示意

手指 fling ──▶ 父容器滚动 ──▶ 撞上子view边界 ──▶ 速度传给子view ▲ │ │ ▼ 子view滚到顶/底 ◀── 子view继续惯性滚动 ◀── 子view fling （ChildLinkageEvent 回调）

💡 一句话总结设计逻辑：父容器管"轨道"，Handler 管"能力"，Event 管"到站通知"，速度跟踪管"无缝换乘"。四者各司其职，任何单一组件都不需要知道全局。

嵌套滚动（NestedScroll）如何融入

Android 官方提供了NestedScrollingParent/NestedScrollingChild机制，ELinkageScroll 是它的深度使用者：

• 容器实现NestedScrollingParent（见 onNestedPreScroll），子 view 实现NestedScrollingChild（如LWebView）
• 手指 MOVE 时，子 view 先dispatchNestedPreScroll把位移"让"给容器判断，容器根据scrollY与该子 view 边界的位置关系决定：全消费、消费一部分、或完全放行给子 view
• onNestedPreFling中，若子 view 正位于自身边界（scrollY == targetEdge.topEdge），容器选择"跟踪速度 + 放行"，等子 view 先滚到头再交接；否则容器直接接管 fling

这套"让权—接管"的协商，使得任何第三方滚动 View 只要支持嵌套滚动，理论上都能接入这套联动体系。

接口契约：接入成本有多低？

子 view 侧只需实现 ILinkageScroll.java 的 2 个方法：

• provideScrollHandler()：返回自己的LinkageScrollHandler
• setChildLinkageEvent(event)：保存容器注入的回调

容器在 onFinishInflate 中做强制校验：任何未实现该接口的子 view 会直接抛出运行时异常，把配置错误挡在启动时而不是滚动时。这是"契约式编程"的典型体现——能力声明即义务。

手势层面，容器用 PosIndicator.java 辅助识别拖拽方向与位移，并在onInterceptTouchEvent中拦截落在不可滚动子 view上的滑动，让固定内容区域也能流畅翻页。

快速上手：5 分钟接入

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/el/ELinkageScroll
2. 在布局 XML 中用ELinkageScrollLayout作为根容器，把要联动的子 view 换成LWebView/LRecyclerView/LScrollView等 L 系列组件，完整示例见 activity_main.xml 与 README.md 的 XML 片段
3. 自定义 View 接入：继承目标控件 → 实现ILinkageScroll→ 在provideScrollHandler()中暴露自己的滚动 API（参考最简形态 LTextView.java 与完整形态 LWebView.java）

Demo 页面同时混合了 WebView、LinearLayout、RecyclerView、TextView、ScrollView 7 段子 view，可直接运行MainActivity体验"一个轨道滚全页"的效果。

关键文件地图

总结

ELinkageScroll 的架构可以用三层话概括：

• 结构层：ELinkageScrollLayout把 N 个子 view 拼成一条可整体滚动的轨道，用 ViewEdge 边界表 + 方向状态机管理"谁在当值"
• 契约层：ILinkageScroll+LinkageScrollHandler让每个子 view 以统一接口上报能力、接受驱动，接入成本趋近于零
• 协调层：双向 fling 交接 + 速度跟踪，让"父滚动 → 子滚动 → 父滚动"的接力全程不掉速

这套设计不依赖任何第三方库、类数量极少，却完整覆盖了嵌套滚动的全部难点，值得每一个做复杂页面滚动的 Android 开发者精读一遍。