InheritedWidget

757 阅读6分钟

Flutter组件构建浅析一文中介绍Widget组件时,曾将Widget分为三类,提到InheritedWidget是全局状态管理的重要组件,它在感知数据变动后会通知依赖的组件更新

  • StatelessWidget、StatefullWidget 可以组合Widget,形成Widget树
  • ProxyWidget 其子类InheritedWidget是全局状态管理的重要组件
  • RenderObjectWidget 可以创建renderObject对象用于布局绘制

但在实际开发过程中InheritedWidget是很少直接使用的,一般我们会直接使用Provider、Riverpod这样的包,它们的底层都是基于InheritedWidget的,所以了解一下InheritedWidget有助于理解其工作原理。

Demo

首先通过一个demo看下如何使用InheritedWidget,这是一个抽象类,继承之后需要复写updateShouldNotify即可,除此之外

  • count是持用共享的数据
  • read、watch为工具方法,方便全局调用
  • BuildContext是一个接口,Element实现了这个接口,StalessWidget和StatefulWidget的build方法的传参都是当前Element,使用接口而不是实现类具有更大的灵活性,看到BuildContext可以将他们看作Element
class ShareCountWidget extends InheritedWidget {
  const ShareCountWidget(
      {Key? key, required Widget child, required this.count})
      : super(key: key, child: child);
  final int count;

  static int? watch(BuildContext context) {
    return context
        .dependOnInheritedWidgetOfExactType<ShareCountWidget>()
        ?.count;
  }

  static int? read<T>(BuildContext context) {
    ShareCountWidget? widget = context
        .getElementForInheritedWidgetOfExactType<ShareCountWidget>()
        ?.widget as ShareCountWidget;
    return widget.count;
  }

  @override
  bool updateShouldNotify(ShareCountWidget oldWidget) {
    debugPrint("old=${oldWidget.count} vs new=${count}");
    return oldWidget.count!=count;
  }
}

InheritedWidget依赖rebuild感知数据变化,所以放在StatefulWidget中,ShareCountWidget的child为了避免重建,传参要来自外部,否则setState就重建了,不是我们想要的效果,后面分析会说到。现在每点击一次,有以下变化

  • count自增
  • 打印_ProviderWidgetState build
  • GestureDetector、ShareCountWidget会new一个新的

不变的是

  • widget.child参数
class ProviderWidget extends StatefulWidget {
   const ProviderWidget({Key? key, required this.child})
      : super(key: key);

  final Widget child;

  @override
  State<ProviderWidget> createState() => _ProviderWidgetState();
}

class _ProviderWidgetState extends State<ProviderWidget> {
  int count=0;

  @override
  Widget build(BuildContext context) {
    debugPrint("_ProviderWidgetState build");
    return GestureDetector(
      child: ShareCountWidget(count: count, child: widget.child),
      onTap: () => setState(() {count++;}),
    );
  }
}

最后整合到根页面上,每次点击屏幕,

  • 第一个Text只显示初始化的0,既没有打印“build Text 1”,数字也不会变化,
  • 第二个Text数字会加一,同时打印“build Text 2”

它们的不同在于一个用的read方法而另一个用的watch方法,有什么区别,这里为什么要用Builder包装Text,为什么用innerContext而不是上面的context

class Start extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ProviderWidget(
        child: MaterialApp(
          home: Scaffold(
            body: Center(
              child: Row(
                mainAxisAlignment: MainAxisAlignment.center,
                children: [
                  Builder(builder: (BuildContext innerContext) {
                    debugPrint("build Text 1");
                    return Text(ShareCountWidget.read(innerContext)?.toString() ?? "");
                  }),
                  const SizedBox(width: 8),
                  Builder(builder: (BuildContext innerContext) {
                    debugPrint("build Text 2");
                    return Text(ShareCountWidget.watch(innerContext)?.toString() ?? "");
                  }),
                ],
              ),
            ),
          ),
        ));
  }
}

InheritedWidget工作原理

Widget的设计都是轻量级的,InheritedWidget也是,其对应的InheritedElement才是重点,先看在Flutter组件构建浅析中提到的_updateInheritance方法,Element中的此方法就是直接指向父类中_inheritedWidgets,一般都是空

Element

Map<Type, InheritedElement>? _inheritedWidgets;

void mount(Element? parent, Object? newSlot) {
   ...
   // inheritWidget相关
    _updateInheritance();
    ...
  }
  
void _updateInheritance() {
    _inheritedWidgets = _parent?._inheritedWidgets;
}

在Element的子类中,InheritedElement对其进行了复写,内容也很明了:如果父类的不为空先复制过来,为空就初始化,再把当前InheritedElement和其关联的Widget以键值对的形式存在map中,随着Element树的构建,后面的子Element都指向这个map(单InheritedWidget),这是状态能在全局共享的基础,所以要想数据服务范围广,InheritedWidget就要往树顶靠。

  @override
  void _updateInheritance() {
    final Map<Type, InheritedElement>? incomingWidgets = _parent?._inheritedWidgets;
    if (incomingWidgets != null) {
      _inheritedWidgets = HashMap<Type, InheritedElement>.of(incomingWidgets);
    } else {
      _inheritedWidgets = HashMap<Type, InheritedElement>();
    }
    _inheritedWidgets![widget.runtimeType] = this;
  }

那这个map是在哪使用的呢,搜索_inheritedWidgets会发现当前使用的两个方法就是我们前面封装的工具方法,两个方法都从map中获取InheritedElement,由于子Element都持用这个map,所以只要在InheritedElement之下,无论什么位置都能直接调用,

  @override
  T? dependOnInheritedWidgetOfExactType<T extends InheritedWidget>({Object? aspect}) {
    final InheritedElement? ancestor = _inheritedWidgets == null ? null : _inheritedWidgets![T];
    if (ancestor != null) {
      // 比下面方法多这个调用
      return dependOnInheritedElement(ancestor, aspect: aspect) as T;
    }
    _hadUnsatisfiedDependencies = true;
    return null;
  }

  @override
  InheritedElement? getElementForInheritedWidgetOfExactType<T extends InheritedWidget>() {
    final InheritedElement? ancestor = _inheritedWidgets == null ? null : _inheritedWidgets![T];
    return ancestor;
  }

前面的demo为什么不用context,因为它在InheritedElement之上,为什么用Builder,其实就是为了使用innerContext参数,它在InheritedElement之下

class Start extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ProviderWidget(
      ...
      Builder(builder: (BuildContext innerContext) {
        debugPrint("build Text 1");
        return Text(ShareCountWidget.read(innerContext)?.toString() ?? "");
      }),
     ...
  }
}

上面两个方法的重要不同在于第一个多了dependOnInheritedElement方法调用,而这个调用很是关键,干了两件事

  • 从调用者角度看,我这个Element依赖了谁, 通过 _dependencies!.add(ancestor)记录下这个InheritedElement
  • 从InheritedElement角度看,谁依赖了我,通过ancestor.updateDependencies(this, aspect)记录下来这个Element,后面如有更新要通知它,这就是为什么demo里使用watch方法的Text有刷新
  @override
  InheritedWidget dependOnInheritedElement(InheritedElement ancestor, { Object? aspect }) {
    _dependencies ??= HashSet<InheritedElement>();
    _dependencies!.add(ancestor);
    ancestor.updateDependencies(this, aspect);
    return ancestor.widget as InheritedWidget;
  }
  
  InheritedElement
  
   void updateDependencies(Element dependent, Object? aspect) {
    setDependencies(dependent, null);
  }
  
  final Map<Element, Object?> _dependents = HashMap<Element, Object?>();
    
   @protected
  void setDependencies(Element dependent, Object? value) {
    _dependents[dependent] = value;
  }

那它又是如何通知的呢,下面这张图来自StatefulWidget,具体的构建流程不再重述了,图的右下角涉及InheritedElement

flutter组件build流程.png 当setState触发rebuild,看InheritedElement的update是怎么更新的,update方法由InheritedElement的父类ProxyElement复写,其先调用updated方法,不要和update混淆了,这个updated方法被InheritedElement复写了,复写的目的就是先问问InheritedWidget这个更新要不要通知,比如数据都没变化就不要通知了

ProxyElement
  @override
  void update(ProxyWidget newWidget) {
    final ProxyWidget oldWidget = widget as ProxyWidget;
    super.update(newWidget);
    // InheritedElement有复写
    updated(oldWidget);
    _dirty = true;
    rebuild();
  }

InheritedElement
  @override
  void updated(InheritedWidget oldWidget) {
    if ((widget as InheritedWidget).updateShouldNotify(oldWidget)) {
      super.updated(oldWidget);
    }
  }

如果InheritedWidget子类复写的这个updateShouldNotify方法判断要通知,才会调用了父类的updated方法,比如我们的demo就比较了新旧count不同时才通知。

 @override
  bool updateShouldNotify(ShareCountWidget oldWidget) {
    debugPrint("old=${oldWidget.count} vs new=${count}");
    return oldWidget.count!=count;
  }

updated里面就是通知更新的实现了,前面说过_dependents保存了依赖这个InheritedElement的Elements,现在依次调用它们的didChangeDependencies就会引起Element重建了

  @protected
  void updated(covariant ProxyWidget oldWidget) {
    // 这个方法又是子类实现的
    notifyClients(oldWidget);
  }
  
    @override
  void notifyClients(InheritedWidget oldWidget) {
    for (final Element dependent in _dependents.keys) {
     ...
      notifyDependent(oldWidget, dependent);
    }
  }

  void notifyDependent(covariant InheritedWidget oldWidget, Element dependent) {
    dependent.didChangeDependencies();
  }

  void didChangeDependencies() {
    // 重建
    markNeedsBuild();
  }

StatefulElement对didChangeDependencies方法有复写,我们在StatefulWidget中关于初始化的第三点提到,InheritedElement会涉及_didChangeDependencies这个值就在这里,那么state.didChangeDependencies()的调用时机也就来源于此

StatefulElement

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    _didChangeDependencies = true;
  }

  @override
  void performRebuild() {
    if (_didChangeDependencies) {
      state.didChangeDependencies();
      _didChangeDependencies = false;
    }
    super.performRebuild();
  }

当依赖的Elements被标记需要重建后,下一帧会执行rebuild,但此后InheritedElement的rebuild是会向下传递的,如果子节点update时也依次rebuild了,上面的通知也就没什么意义了,所以在上面流程图中,我们希望子节点的update走下面的红色路线,维持现状,结束向下build流程,只有被通知的Elements重建从而实现局部刷新。

flutter组件build流程 (17).png

这就是为什么demo中ShareCountWidget直接接受外部的传参作为子节点,只要这个外部参数不变就实现了上面的红色路线。

参考 跨组件状态共享