Flutter——PageView的PageController源码分析笔记

前言

因为公司需求，对PageView的PageController的进行了拆解，这里将所记得笔记分享一哈。
复制代码

PageController

构造函数 简介

PageController继承自ScrollController extends ChangeNotifier（pageController并无作什么扩展、只是复写了一些方法），由ChangeNotifier可见controller中的属性是能够向外通知的。（具体可见Provider） 构造函数：

PageController({
    this.initialPage = 0,   //初始显示的页面
    this.keepPage = true,   //是否保持页面
    this.viewportFraction = 1.0, //viewport 系数
  })
复制代码

viewportFraction是一个系数，决定pageview的page的大小，即（假设是横向）：外层容器宽度*viewportFraction。 同时在滚动的位置计算也会用到这个变量，具体后面会见到

PageController 内部结构图

createScrollPosition()

其中这个方法会在父类的_updatePosition（）中调用，而 _updatePosition()在这里两个生命周期中会调用：

didChangeDependencies（），didUpdateWidget（），

因而可知，createScrollPosition()在页面建立和刷新时是会调用。 它会返回一个 _PagePosition():

return _PagePosition(
      physics: physics,
      context: context,
      initialPage: initialPage,
      keepPage: keepPage,
      viewportFraction: viewportFraction,
      oldPosition: oldPosition,
    )
复制代码

其中physics，咱们没传的话，系统会默认传一个_kPagePhysics(类PageScrollPhysics),另外在使用pageview时，若是咱们不传controller，系统也会传一个默认的 _defaultPageController（类PageController）。

接下来咱们看一下PageScrollPhysics，（以后再回来看_PagePosition）

PageScrollPhysics 及结构图

PageScrollPhysics 继承自ScrollPhysics，用来决定滚动时的物理特性。若是你对pageview、listview等等的滚动效果不满意，就能够从这里入手，定义本身的physics。

它主要有4个方法，分别是：

_getPage(ScrollMetrics position)

_getPixels(ScrollMetrics position, double page)

_getTargetPixels(ScrollMetrics position, Tolerance tolerance, double velocity)

以上三个是用于根据页面取得滚动位置或者根据位置取得页面的，他们三个组合到一块儿，就能够实现pageview 的一次滚动一个页面、滑动过半自动滚动到下一页的效果。

第4个方法createBallisticSimulation(ScrollMetrics position, double velocity)

该方法会组装一个含有起点和终点的,滑动时带有弹簧阻尼效果的Simulation，并返回。 具体哪里用到，后面会说，这里咱们回到_PagePosition

_PagePosition

这里结构比较复杂，较深的类我只贴结构图（内带注释），尽可能减小文字。
继承关系（上到下：子到父）：
_PagePosition
    ↓
ScrollPositionWithSingleContext implements ScrollActivityDelegate
    ↓
ScrollPosition with ScrollMetrics
    ↓
ViewportOffset
    ↓
ChangeNotifier （能够发现、它的子类是具备向外通知的功能的）
复制代码

ViewportOffset

ScrollPosition

ScrollMetrics

ScrollPositionWithSingleContext

这个类是pagePosition的直接父类，它实现了接口ScrollActivityDelegate（抽象类。dart实际没有接口的概念），ScrollActivityDelegate定义了几个方法其中经常使用的是：

void goIdle();  //中止滚动

void goBallistic(double velocity);//弹性滚动
复制代码

咱们就来看一看goBallistic的具体实现吧：

@override
  void goBallistic(double velocity) {
    assert(pixels != null);
    final Simulation simulation = physics.createBallisticSimulation(this, velocity);
    if (simulation != null) {
      beginActivity(BallisticScrollActivity(this, simulation, context.vsync));
    } else {
      goIdle();
    }
  }
复制代码

注意这句：physics.createBallisticSimulation(this, velocity); 这里就是调用咱们上面说的PageScrollPhysics中的方法createBallisticSimulation，它返回的simulation用于生成一个BallisticScrollActivity会交给beginActivity来处理（没有返回的话就呆住啦~）。

咱们先来了解一下ScrollActivity
复制代码

ScrollActivity

ScrollActivity是个抽象类、内部有一些分发通知的方法和几个变量，如：是否滚动、滚动速度等等。 flutter里，据我所知各类的滚动样式活动（drag、fling等）都是继承自ScrollActivity。如上面的BallisticScrollActivity。对于它的理解我是这样想的： Simulation是描述一个物理效果、ScrollActivity的子类来展示这个效果，咱们看一下他的构造函数就一目了然了：

BallisticScrollActivity(
    ScrollActivityDelegate delegate,
    Simulation simulation,
    TickerProvider vsync,
  ) : super(delegate) {
    _controller = AnimationController.unbounded(
      debugLabel: kDebugMode ? objectRuntimeType(this, 'BallisticScrollActivity') : null,
      vsync: vsync,
    )
      ..addListener(_tick)
      ..animateWith(simulation)
       .whenComplete(_end); // won't trigger if we dispose _controller first } 复制代码

回到ScrollPositionWithSingleContext

虽然pagePosition 继承自ScrollPositionWithSingleContext，可是pagePosition里的方法并很少、主要是加了这两个方法：

getPageFromPixels（），getPixelsFromPage（）
复制代码

这些方法在PageScrollPhysics中会用到(辅助达到一次一页的效果)。

父类ScrollPositionWithSingleContext内部定义了咱们常见animateTo(),jumpTo()等等、对应的会生成一些列scrollActivity的子类用于驱动，如：DrivenScrollActivity\BallisticScrollActivity\IdleScrollActivity

这里再放一下controller的结构图(注意左侧):
复制代码

到这里pagePosition的内部结构就基本解剖完了，同时也回到了最初的controller的createScrollPosition，即整个控制流程的分析就结束了。

文章比较长，谢谢你们观看。如有错误的地方或者没说明白的，还请指正，感谢。
复制代码

意外发现

扒源码的时候，我发现官方的scrollcontroller 其实是支持指定item进行滚动的，咱们能够看一下上面scrollPosition的结构图（图内底部），其中有一个方法ensureVisible（），能够滚动到指定的RenderObject，目前我试了一下scrollView等（非回收的）效果完美。可是listview不行（屏幕内能够），应该是因为listview的屏外child（超出缓存）会被回收的缘由的，拿不到RenderObject，这个仍是有待研究。 你们有啥想法能够交流一哈。

相关文章

PageView源码和Gesture竞技场消歧的浅析