定义和用法
本文只对InheritedWidget进行分析,需要读者具备一些基础知识,包括但不限于:
- Flutter的基本知识;
- Widget、Element的关系
一个可以高效的沿着树高效传递信息的基础Widget。
用户可使用BuildContext.dependOnInheritedWidgetOfExactType
获取最近特定类型的InheritedWidget
实例,之后每当被引用的InheritedWidget
自身状态发生变化时,会导致引用者重新build。
按照官方教程,粗略的提一下用法(此处不再赘述详细的用法,可参考数据共享(InheritedWidget)):
- 首先定义一个
InheritedWidget
类型的Widget:
//官方Demo
class FrogColor extends InheritedWidget {
const FrogColor({
Key key,
@required this.color,
@required Widget child,
}) : assert(color != null),
assert(child != null),
super(key: key, child: child);
final Color color;
static FrogColor of(BuildContext context) {
return context.dependOnInheritedWidgetOfExactType();
}
@override
bool updateShouldNotify(FrogColor old) => color != old.color;
}
- 将该Widget作为普通Widget添加到Widget树中;
- 在其任一子Widget中使用
FrogColor.of(context).color
即可获得color
信息。
要想做到子Widget数据刷新,有两个关键点:
- 子Widget如何如何跨Widget拿到
InheritedWidget
-
InheritedWidget
如何在数据改变时通知子Widget刷新(build)
这两点就是InheritedWidget
的核心和关键所在,接下来我们对着两个问题进行分析:
InheritedWidget
在树中的传递
在上面的示例代码中,子Widget中唯一可见和InheritedWidget发生关联的代码就是FrogColor.of(context).color
。其中的关键方法是dependOnInheritedWidgetOfExactType
,该方法在BuildContext
中定义,并在Element
中有具体实现。查看BuildContext.dependOnInheritedWidgetOfExactType
在Element
中的源码如下:
Map _inheritedWidgets;
@override
T dependOnInheritedWidgetOfExactType({Object aspect}) {
assert(_debugCheckStateIsActiveForAncestorLookup());
final InheritedElement ancestor = _inheritedWidgets == null ? null : _inheritedWidgets[T];
if (ancestor != null) {
assert(ancestor is InheritedElement);
return dependOnInheritedElement(ancestor, aspect: aspect) as T;
}
_hadUnsatisfiedDependencies = true;
return null;
}
可以看到,每个Element实例都持有一个_inheritedWidgets
,每当要为Widget添加特定类型的依赖时,就会从该集合里取出相关类型的InheritedElement
实例。那么_inheritedWidgets
是在何时保存了InheritedElement
的呢?
接下来继续看Element源码,查看_inheritedWidgets
在何时赋值。
在element中有一个_updateInheritance
方法:
void _updateInheritance() {
assert(_active);
_inheritedWidgets = _parent?._inheritedWidgets;
}
它在mount
和activate
函数执行时被调用。也就是说每次element挂载和重新启用时,element都会从它的上层element中打包拿到其所持有的所有InheritedElement
。
InheritedElement
继承了Element
,并重写了_updateInheritance
方法:
@override
void _updateInheritance() {
assert(_active);
final Map incomingWidgets = _parent?._inheritedWidgets;
if (incomingWidgets != null)
_inheritedWidgets = HashMap.from(incomingWidgets);
else
_inheritedWidgets = HashMap();
_inheritedWidgets[widget.runtimeType] = this;
}
相较于普通的Element
,InheritedElement
不仅会拿到其上层element所有的InheritedElement
,而且会将自己也作为一个元素添加到集合中。
不难看出,每个Element都会持有一个集合,该集合持有其上层Element中出现的所有InheritedElement
,每当出现一个InheritedElement
,该InheritedElement
会将其自身添加到该集合中,并向下传递。InheritedWidget
正是通过这种方法确保下层控件可以访问到其上层中所有的InheritedWidget
。
InheritedWidget如何进行刷新
当InheritedWidget的状态发生变化时,它是如何通知相关子树进行刷新呢,我们继续分析dependOnInheritedWidgetOfExactType
方法的代码,当从_inheritedWidgets
中能取出特定类型的实例ancestor
时。会执行dependOnInheritedElement
方法:
@override
InheritedWidget dependOnInheritedElement(InheritedElement ancestor, { Object aspect }) {
assert(ancestor != null);
_dependencies ??= HashSet();
_dependencies.add(ancestor);
ancestor.updateDependencies(this, aspect);
return ancestor.widget;
}
InheritedElement
实例会调用自己的updateDependencies
方法并将当前Element实例传递过去:
final Map _dependents = HashMap();
@protected
void updateDependencies(Element dependent, Object aspect) {
setDependencies(dependent, null);
}
@protected
void setDependencies(Element dependent, Object value) {
_dependents[dependent] = value;
}
InheritedElement
中,通过_dependents
集合保存所有与该实例发生依赖的Widget。每次有Widget与InheritedElement
建立依赖关系时,都会讲自己添加到InheritedElement
的集合中。而当InheritedElement
更新时,会执行实例上的 notifyClients
:
@override
void notifyClients(InheritedWidget oldWidget) {
assert(_debugCheckOwnerBuildTargetExists('notifyClients'));
for (final Element dependent in _dependents.keys) {
assert(() {
// check that it really is our descendant
Element ancestor = dependent._parent;
while (ancestor != this && ancestor != null)
ancestor = ancestor._parent;
return ancestor == this;
}());
// check that it really depends on us
assert(dependent._dependencies.contains(this));
//遍历所有的element
notifyDependent(oldWidget, dependent);
}
}
@protected
void notifyDependent(covariant InheritedWidget oldWidget, Element dependent) {
//依次调用所有子element的didChangeDependencies方法
dependent.didChangeDependencies();
}
在element的didChangeDependencies
方法中会调用markNeedsBuild
方法,该方法会将标记当前元素,并在下一帧到来时重新创建Widget,具体实现原理已经脱离InheritedWidget
的知识范畴,这里不再进行讨论。
总结
InheritedWidget
的关键核心是两个集合。通过一个沿树自上而下传递的集合存储所有上层组件中的InheritedWidget
,以便Widget可以拿到任意上层树种的InheritedWidget
。而在InheritedWidget
则通过一个集合持有所有的依赖元素,每当有元素与其发生依赖关系,该元素就被被添加入集合中。当InheritedWidget
的状态发生改变时,将遍历该集合并执行每个元素的didChangeDependencies
方法。