Flutter | 深刻理解BuildContext

前言

最近看到一些刚接触Flutter的同窗在进行页面跳转的时候,出现了这个问题。bash

flutter: Navigator operation requested with a context that does not include a Navigator.
flutter: The context used to push or pop routes from the Navigator must be that of a widget that is a
flutter: descendant of a Navigator widget.
复制代码

代码是这样的markdown

import 'package:flutter/material.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: FlatButton(
              onPressed: () {
                Navigator.of(context).push(
                    MaterialPageRoute(builder: (context) => SecondPage()));
              },
              child: Text('跳转')),
        ),
      ),
    );
  }
}

class SecondPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(),
    );
  }
}
复制代码

一眼看上去好像没什么问题,解决方式也很简单,把home部分做为一个新的Widget拆出来就能够了。app

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: FirstPage(),
    );
  }
}

class FirstPage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
        body: Center(
          child: FlatButton(
              onPressed: () {
                Navigator.of(context).push(
                    MaterialPageRoute(builder: (context) => SecondPage()));
              },
              child: Text('跳转')),
        ),
      );
  }
}
复制代码

可是刚开始遇到这些东西的时候必定是很懵逼的。BuildContext是什么鬼,为何每次咱们须要在build函数的时候传入一个BuildContext?为何个人Navigator操做会出现当前的context找不到Navigator的状况,为何拆成新的widget就行了?less

因此今天想顺着这个问题跟你们分享一下如何在Flutter中理解和使用BuildContext。其中还会涉及到一些widget构建流程的地方,在正式开始以前先简单解释一下这几个概念。ide

什么是Navigator,MaterialApp作了什么

咱们常常会在应用中打开许多页面,当咱们返回的时候,它会前后退到上一个打开的页面,而后一层一层后退,没错这就是一个堆栈。而在Flutter中,则是由Navigator来负责管理维护这些页面堆栈。函数

压一个新的页面到屏幕上
Navigator.of(context).push
把路由顶层的页面移除
Navigator.of(context).pop
复制代码

一般咱们咱们在构建应用的时候并无手动去建立一个Navigator,也能进行页面导航,这又是为何呢。ui

没错,这个Navigator正是MaterialApp为咱们提供的。可是若是home,routes,onGenerateRoute和onUnknownRoute都为null,而且builder不为null,MaterialApp则不会建立任何Navigator。this

知道了Navigator和MaterialApp发挥的做用以后,咱们再来看看BuildContext。spa

BuildContext

每次咱们在编写界面部分代码的时候,都是在build函数中进行操做。而build函数则须要默认传入一个BuildContext。咱们来看看这究竟是啥。code

abstract class BuildContext {
  /// The current configuration of the [Element] that is this [BuildContext].
  Widget get widget;

  /// The [BuildOwner] for this context. The [BuildOwner] is in charge of
  /// managing the rendering pipeline for this context.
  BuildOwner get owner;
  ...
复制代码

咱们能够看到BuildContext实际上是一个抽象类,可是每次build函数传进来的是什么呢。咱们来看看构建视图的时候到底发生了什么。

Flutter如何构建视图

在Flutter中,Everything is Widget,咱们经过构造函数嵌套Widget来编写UI界面。实际上,Widget并非真正要显示在屏幕上的东西,只是一个配置信息,它永远是immutable的,而且能够在多处重复使用。那真正显示在屏幕上的视图树是什么呢?Element Tree!

那咱们来看一下,在构建视图的时候究竟发生了什么。这里以Stateless Widget为例。

abstract class StatelessWidget extends Widget {
  const StatelessWidget({ Key key }) : super(key: key);
  @override
  StatelessElement createElement() => StatelessElement(this);
  ...
复制代码

当要把这个widget装进视图树的时候,首先会去createElement,并将当前widget传给Element。

咱们再来看一看这个StatelessElement是什么

class StatelessElement extends ComponentElement {
  /// Creates an element that uses the given widget as its configuration.
  StatelessElement(StatelessWidget widget) : super(widget);

  @override
  StatelessWidget get widget => super.widget;

  @override
  Widget build() => widget.build(this);

  @override
  void update(StatelessWidget newWidget) {
    super.update(newWidget);
    assert(widget == newWidget);
    _dirty = true;
    rebuild();
  }
}
复制代码

咱们能够看到,经过将widget传入StatelessElement的构造函数,StatelessElement保留了widget的引用,而且将会调用build方法。

而这个build方法真正调用的则是widget的build方法,并将this,也就是该StatelessElement对象传入。咱们知道,build方法须要传入的是一个BuildContext,为何传进去了StatelessElement?因而咱们继续看。

class StatelessElement extends ComponentElement ... abstract class ComponentElement extends Element ... abstract class Element extends DiagnosticableTree implements BuildContext 复制代码

其实是Element类实现了BuildContext,并由ComponentElement -> StatelessElement 继承。

因此咱们如今再来看官方对于BuildContext的解释:

BuildContextobjects are actually Element objects. The BuildContextinterface is used to discourage direct manipulation of Element objects.

BuildContext对象实际上就是Element对象,BuildContext 接口用于阻止对 Element 对象的直接操做。

Cool!咱们如今终于知道这个BuildContext是哪里来的了。让咱们再来梳理一下,flutter构建视图究竟作了什么。

视图树装载过程

StatelessWidget

  • 首先它会调用StatelessWidget的 createElement 方法,并根据这个widget生成StatelesseElement对象。
  • 将这个StatelesseElement对象挂载到element树上。
  • StatelesseElement对象调用widget的build方法,并将element自身做为BuildContext传入。

StatefulWidget

  • 首先一样也是调用StatefulWidget的 createElement方法,并根据这个widget生成StatefulElement对象,并保留widget引用。
  • 将这个StatefulElement挂载到Element树上。
  • 根据widget的 createState 方法建立State。
  • StatefulElement对象调用state的build方法,并将element自身做为BuildContext传入。

因此咱们在build函数中所使用的context,正是当前widget所建立的Element对象。

of(context)方法

在flutter中咱们常常会使用到这样的代码

//打开一个新的页面
Navigator.of(context).push
//打开Scaffold的Drawer
Scaffold.of(context).openDrawer
//获取display1样式文字主题
Theme.of(context).textTheme.display1
复制代码

那么这个of(context)究竟是个什么呢。咱们这里以Navigator打开新页面为例。

static NavigatorState of(
    BuildContext context, {
      bool rootNavigator = false,
      bool nullOk = false,
    }) {
//关键代码-----------------------------------------v
    
    final NavigatorState navigator = rootNavigator
        ? context.rootAncestorStateOfType(const TypeMatcher<NavigatorState>())
        : context.ancestorStateOfType(const TypeMatcher<NavigatorState>());
        
//关键代码----------------------------------------^
    assert(() {
      if (navigator == null && !nullOk) {
        throw FlutterError(
          'Navigator operation requested with a context that does not include a Navigator.\n'
          'The context used to push or pop routes from the Navigator must be that of a '
          'widget that is a descendant of a Navigator widget.'
        );
      }
      return true;
    }());
    return navigator;
  }
复制代码

能够看到,关键代码部分经过context.rootAncestorStateOfType向上遍历 Element tree,并找到最近匹配的 NavigatorState。也就是说of其实是对context跨组件获取数据的一个封装。

而咱们的Navigator的 push操做就是经过找到的 NavigatorState 来完成的。

不只如此,BuildContext还有许多方法能够跨组件获取对象

ancestorInheritedElementForWidgetOfExactType(Type targetType) → InheritedElement

ancestorRenderObjectOfType(TypeMatcher matcher) → RenderObject

ancestorStateOfType(TypeMatcher matcher) → State

ancestorWidgetOfExactType(Type targetType) → Widget

findRenderObject() → RenderObject

inheritFromElement(InheritedElement ancestor, { Object aspect }) → InheritedWidget

inheritFromWidgetOfExactType(Type targetType, { Object aspect }) → InheritedWidget

rootAncestorStateOfType(TypeMatcher matcher) → State

visitAncestorElements(bool visitor(Element element)) → void

visitChildElements(ElementVisitor visitor) → void
复制代码

须要注意的是,在 State 中 initState阶段是没法跨组件拿数据的,只有在didChangeDependencies以后才可使用这些方法。

回顾问题

咱们如今再来看看以前遇到的 当前 context 不包含 Navigator 这个问题是否是很简单了呢。

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(
          child: FlatButton(
              onPressed: () {
                Navigator.of(context).push(
                    MaterialPageRoute(builder: (context) => SecondPage()));
              },
              child: Text('跳转')),
        ),
      ),
    );
  }
}
复制代码

当咱们在 build 函数中使用Navigator.of(context)的时候,这个context其实是经过 MyApp 这个widget建立出来的Element对象,而of方法向上寻找祖先节点的时候(MyApp的祖先节点)并不存在MaterialApp,也就没有它所提供的Navigator。

因此当咱们把Scaffold部分拆成另一个widget的时候,咱们在FirstPage的build函数中,得到了FirstPage的BuildContext,而后向上寻找发现了MaterialApp,并找到它提供的Navigator,因而就能够愉快进行页面跳转了。

参考资料

  • Flutter Widgets101:Flutter团队官方视频,介绍了statelessWidget与StatefulWidget到底是怎么被建立的,推荐观看。

写在最后

我这拖延症晚期患者以前有段时间我的事务特别忙就断更了,没想到一水就是整整3个月,看到大佬们都这么努力,想一想这样下去真的太咸鱼了,因此终于又继续开始更博客啦。🤣

文章如有不对之处还请各位高手指出,欢迎在下方评论区以及个人邮箱1652219550a@gmail.com留言,我会在24小时内与您联系!

下一篇是啥尚未想好,多是一个实战系列,反正,你们多多滋瓷啦。😌

相关文章
相关标签/搜索