Flutter key

新创建一个Flutter Application的时候,默认生成的代码里面有这么一段

class MyHomePage extends StatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key);
  
  final String title;
  
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

title很好理解,给AppBar传参使用的,那么另一个参数key是做干什么的呐?
带着这个疑问先看几个小例子:
首先写个小demo作为调试的入口

class DemoKeys extends StatefulWidget {
  DemoKeys({Key key}) : super(key: key);

  @override
  _DemoKeyState createState() => _DemoKeyState();
}

class _DemoKeyState extends State<DemoKeys> {
  List<Widget> widgets = [
    StatelessContainer(),
    StatelessContainer(),
  ];

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Row(
          mainAxisAlignment: MainAxisAlignment.center,
          children: widgets,
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: switchWidget,
        child: Icon(Icons.swap_horizontal_circle),
      ),
    );
  }

  switchWidget() {
    widgets.insert(0, widgets.removeAt(1));
    setState(() {});
  }
}

小demo很简单,屏幕的中间添加两个widget,下方一个按钮,点击按钮,交换两个widget。

场景一:stateless
class StatelessContainer extends StatelessWidget {
  final Color color = randomColor();

  @override
  Widget build(BuildContext context) {
    return Container(
      width: 100,
      height: 100,
      color: color,
    );
  }
}

首先使用两个StatelessWidget进行测试,点击下方按钮,两个方块进行了交换。

stateless
场景二:stateful without key
class StatefulContainer extends StatefulWidget {
  StatefulContainer({Key key}) : super(key: key);
  @override
  _StatefulContainerState createState() => _StatefulContainerState();
}

class _StatefulContainerState extends State<StatefulContainer> {
  final Color color = randomColor();

  @override
  Widget build(BuildContext context) {
    print('StatefulContainerState build');
    return Container(
      width: 100,
      height: 100,
      color: color,
    );
  }
}

当我们把List<Widget> widgets中的StatelessContainer换成StatefulContainer之后,即

List<Widget> widgets = [
  StatelessContainer(),
  StatelessContainer(),
];

再点击按钮,会发现没有任何变化,这是为什么呐?

stateless

稍安勿躁,再看第三个场景

场景三:stateful with key

还是用上面的StatefulContainer,在List<Widget> widgets中添加上key,即

List<Widget> widgets = [
    StatefulContainer(
      key: UniqueKey(),
    ),
    StatefulContainer(
      key: UniqueKey(),
    )
  ];

再次点击按钮发现两个方块又能交换了。

stateless
widget的更新机制

先说几个概念吧,咱们平时编写的Flutter UI 代码操的都是 widget tree,除了这棵树,flutter 还有element treerendObject tree,其中widget是不可变的,是用来描述element,当widget进行改变的时候,会重新创建新的widget,这时候element不一定会重新创建。

widget的源码里面,有这样一个方法:

@immutable
abstract class Widget extends DiagnosticableTree {
  const Widget({ this.key });
  final Key key;
  ···
  static bool canUpdate(Widget oldWidget, Widget newWidget) {
    return oldWidget.runtimeType == newWidget.runtimeType
        && oldWidget.key == newWidget.key;
  }
}

通过这个方法去判断,newWidget是否可以更新oldWidget对应的element。如果可以更新,则element还是使用oldWidget对应的element,只是使用新创建的widget对这个element进行更新。
这样也就解释了场景一只使用stateless widget时发生交换,两个widget的runtimeType一致,又没有传key,canUpdate返回true,这时候将element更新为对应的颜色。

stateless

至于场景二,同样由于没有传key,只做runtimeType比较,更新element,但为啥不变颜色呐。这个问题要从stateful本身说起,大家知道stateful是有state来管理其状态改变。element和state一一对应,下面是官方的解释。

/// The [State] instance associated with this location in the tree.
/// There is a one-to-one relationship between [State] objects and the
/// [StatefulElement] objects that hold them. The [State] objects are created
/// by [StatefulElement] in [mount].

在statefulContainer中的颜色是定义在state中的,虽然交换了widget,但是其element及对应的state并没有发生改变,所以方块看起来没有任何变化。

无key交换

对于场景三由于加上key之后canUpdate返回false(runtimeType 相同,key 不同),不能再更新element,这时候旧的widgetelement的关联关系发生了改变

[图片上传失败...(image-ae4b21-1571646111867)]

此时 RenderObjectElement 会用新 Widget 的 key 在老 Element 列表里面查找,找到匹配的则会更新 Element 的位置并更新对应 renderObject 的位置,所以颜色发生了变化。

查找
比较范围

对widget的更新机制有一定了解后,咱们看最后一个例子吧。

List<Widget> widgets = [
    Padding(
//      key: UniqueKey(),
      padding: const EdgeInsets.all(8.0),
      child: StatefulContainer(
        key: UniqueKey(),
      ),
    ),
    Padding(
//      key: UniqueKey(),
      padding: const EdgeInsets.all(8.0),
      child: StatefulContainer(
        key: UniqueKey(),
      ),
    ),
  ];

在场景三:stateful with key的widget之上包一层padding,这时候点击按钮你将会看到,每次颜色都会发生变化

padding

这是由于Flutter的比较算法(diff)是有范围的,它是对特定层级进行比较,

padding

这里首先比较padding,其runtimeType一致,所以交换两个widget时,只会更新其element,然后再比较下一个层级,在这个层级并不能找到一个和自己相同的key valu,所以会创建一个新的。之前stateful 两个节点都在一个row 节点内,属于同一个层级,所以虽然交换了之后,在同一个层级内能找到相同key的element,因此并不会创建新的element。
statefulContainery每次都是重新创建的,所以每次看到的效果是一直在变化颜色。

将最后一个场景注释掉的代码打开,即给padding也加一个key,这种情况就和场景三是一样的,key对应不上,移除匹配关系,然后在同一层级重新查找,更新widget和element对应关系。

Key种类

经过以上讲解,想必对key的作用也有了一定的了解,它能用于帮助我们保存widget的状态。上面咱们使用了UniqueKey()

,如果再好奇一点,点进Key的文档中看看,你会发现Key主要有两大种类LocalKeyGlobalKey,使用的所有key的子类都应该继承这两个类。
LocalKey的子类有ValueKeyObjectKeyUniqueKeyPageStorageKey
GlobalKey的子类有LabeledGlobalKeyGlobalObjectKey
那么什么情况下该使用哪种key呐?

ValueKey
官方视频举例是,当你有一个TODO List列表,每完成一个任务,就把这个列表删除的时候可以使用valuekey,因为列表上的text是个value,一个value即可标识出唯一性。

ObjectKey
一个班级里可能有重名的学生,想要标识每一个学生再使用valuekey可能不太合适,不过每个学生还有一些其他信息,比如生日、年龄家庭住址等,信息更复杂,或许其中的单个项有重复,但是当他们组合在一起时,就能够唯一标示每一个学生了,这时候使用ObjectKey是个不错的选择。

UniqueKey
如果需要更进一步确保,每个widget是唯一的,可以使用UniqueKey,demo中使用的也是UniqueKey。但是有种情况需要考虑,每次widget有改变的时候会生成新的UniqueKey,这样之前的key就丢失了,失去了一致性,每次都会重新创建element,那这种情况还不如不使用。

PageStorageKey
当你有一个滑动列表,你通过某一个 Item 跳转到了一个新的页面,当你返回之前的列表页面时,你发现滑动的距离回到了顶部。这时候,给 Sliver 一个 PageStorageKey!它将能够保持 Sliver 的滚动状态。

GlobalKey
GlobalKey是全局的,可以保存widget中任何地方使用,而不用担心状态丢失等,也可以用来传递widget中的信息,不过方便带来的是更大的开销,它维护一个全局的Map来标识GlobalKey与之对应的Element。

LabeledGlobalKey
用来debugging调试,标识GlobalKey的信息。

GlobalObjectKey
经常用来绑定一个widget和生辰这个widget的object。

最后补充一点,在测试场景二的时候,交换了widget,虽然两个widget的描述信息完全一样,并且element也没有重新创建,但是build每次都会执行,我的理解是,widget和element的对应关系发生了改变,因此会重新执行build。具体还需要看updatechild 里面的执行是怎么触发了widget build。

参考文章

Flutter|深入浅出Key

何时使用密钥 - Flutter小部件 101 第四集

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,651评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,468评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,931评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,218评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,234评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,198评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,084评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,926评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,341评论 1 311
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,563评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,731评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,430评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,036评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,676评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,829评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,743评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,629评论 2 354

推荐阅读更多精彩内容

  • 前言 在开发 Flutter 的过程中你可能会发现,一些小部件的构造函数中都有一个可选的参数——Key。刚接触的同...
    Vadaski阅读 6,847评论 15 53
  • 什么是key Key 能够帮助开发者在 Widget tree 中保存状态。 Flutter | 深入浅出Key ...
    Yue_Q阅读 1,890评论 0 2
  • 前言 Flutter 中一切皆 Widget,而 Widget 的构造方法中有个可选参数 Key。一般情况下我们不...
    teletian阅读 2,403评论 0 5
  • Key在Flutter的源码中可以说是无处不在,但是我们日常中确不怎么使用它。有点像是“最熟悉的陌生人”,那么今天...
    唯鹿_weilu阅读 1,190评论 2 3
  • 推荐指数: 6.0 书籍主旨关键词:特权、焦点、注意力、语言联想、情景联想 观点: 1.统计学现在叫数据分析,社会...
    Jenaral阅读 5,717评论 0 5