State
一个StatefulWidget类会对应一个State类,State表示与其对应的StatefulWidget要维护的状态,State中的保存的状态信息可以:
- 在widget 构建时可以被同步读取。
- 在widget生命周期中可以被改变,当State被改变时,可以手动调用其setState()方法通知Flutter framework状态发生改变,
Flutter framework在收到消息后,会重新调用其build方法重新构建widget树,从而达到更新UI的目的。
State中有两个常用属性:
- widget,它表示与该State实例关联的widget实例,由Flutter framework动态设置。
注意,这种关联并非永久的,因为在应用生命周期中,UI树上的某一个节点的widget实例在重新构建时可能会变化,
但State实例只会在第一次插入到树中时被创建,当在重新构建时,如果widget被修改了,Flutter framework会动态设置State.widget为新的widget实例。 - context。StatefulWidget对应的BuildContext,作用同StatelessWidget的BuildContext。
1 // State的生命周期 2 // 实现一个计数器widget,点击它可以使计数器加1,由于要保存计数器的数值状态,所以我们应继承StatefulWidget 3 import 'package:flutter/material.dart'; 4 5 6 // CounterWidget接收一个initValue整型参数,它表示计数器的初始值 7 class CounterWidget extends StatefulWidget { 8 const CounterWidget({Key key, this.initValue: 0}); 9 10 final int initValue; 11 12 @override 13 _CounterWidgetState createState() => _CounterWidgetState(); 14 } 15 16 17 // 18 class _CounterWidgetState extends State<CounterWidget> { 19 int _counter; 20 21 // 当Widget第一次插入到Widget树时会被调用,对于每一个State对象,Flutter framework只会调用一次该回调, 22 // 所以,通常在该回调中做一些一次性的操作,如状态初始化、订阅子树的事件通知等。 23 // 不能在该回调中调用BuildContext.inheritFromWidgetOfExactType(该方法用于在Widget树上获取离当前widget最近的一个父级InheritFromWidget,关于InheritedWidget我们将在后面章节介绍), 24 // 原因是在初始化完成后,Widget树中的InheritFromWidget也可能会发生变化,所以正确的做法应该在在build()方法或didChangeDependencies()中调用它。 25 @override 26 void initState(){ 27 super.initState(); 28 // 初始化状态 29 _counter = widget.initValue; 30 print('initState'); 31 } 32 33 // 主要是用于构建Widget子树的,会在如下场景被调用: 34 // 1. 在调用initState()之后。 35 // 2. 在调用didUpdateWidget()之后。 36 // 3. 在调用setState()之后。 37 // 4. 在调用didChangeDependencies()之后。 38 // 5. 在State对象从树中一个位置移除后(会调用deactivate)又重新插入到树的其它位置之后。 39 @override 40 Widget build(BuildContext context) { 41 print('build'); 42 return Scaffold( 43 appBar: AppBar( 44 title: Text('Test State'), 45 ), 46 body: Center( 47 child: FlatButton( 48 child: Text('$_counter'), 49 // 点击后计数器自增 50 onPressed: ()=>setState(()=>++_counter), 51 ), 52 ), 53 ); 54 } 55 56 // 在widget重新构建时,Flutter framework会调用Widget.canUpdate来检测Widget树中同一位置的新旧节点,然后决定是否需要更新,如果Widget.canUpdate返回true则会调用此回调。 57 // 正如之前所述,Widget.canUpdate会在新旧widget的key和runtimeType同时相等时会返回true,也就是说在在新旧widget的key和runtimeType同时相等时didUpdateWidget()就会被调用。 58 @override 59 void didUpdateWidget(CounterWidget oldWidget) { 60 super.didUpdateWidget(oldWidget); 61 print('didUpdateWidget'); 62 } 63 64 // 当State对象从树中被移除时,会调用此回调。 65 // 在一些场景下,Flutter framework会将State对象重新插到树中,如包含此State对象的子树在树的一个位置移动到另一个位置时(可以通过GlobalKey来实现)。 66 // 如果移除后没有重新插入到树中则紧接着会调用dispose()方法。 67 @override 68 void deactivate() { 69 super.deactivate(); 70 print('deactivate'); 71 } 72 73 // 当State对象从树中被永久移除时调用。通常在此回调中释放资源。 74 @override 75 void dispose() { 76 super.dispose(); 77 print('dispose'); 78 } 79 80 // 此回调是专门为了开发调试而提供的,在热重载(hot reload)时会被调用,此回调在Release模式下永远不会被调用。 81 @override 82 void reassemble() { 83 super.reassemble(); 84 print("reassemble"); 85 } 86 87 // 当State对象的依赖发生变化时会被调用; 88 // 例如:在之前build()中包含了一个InheritedWidget,然后在之后的build()中InheritedWidget发生了变化,那么此时InheritedWidget的子widget的didChangeDependencies()回调都会被调用。 89 // 典型的场景是当系统语言Locale或应用主题改变时,Flutter framework会通知widget调用此回调。 90 @override 91 void didChangeDependencies() { 92 super.didChangeDependencies(); 93 print("didChangeDependencies"); 94 } 95 96 }
十分重要的分析:
-
运行应用并打开该路由页面,在新路由页打开后,屏幕中央就会出现一个数字0,控制台日志输出:
I/flutter (22202): initState
I/flutter (22202): didChangeDependencies
I/flutter (22202): build
由此可知,在StatefulWidget插入到Widget树时首先initState方法会被调用 -
点击热重载按钮,控制台日志输出:
I/flutter (22202): reassemble
I/flutter (22202): didUpdateWidget
I/flutter (22202): build
由此可知,此时initState和didChangeDependencies都没有被调用,而此时didUpdateWidget被调用 -
在widget树移除CountWidget,将路由改为
RaisedButton(
child: Text('Test State'),
textColor: Colors.blue,
onPressed: () {
print('test state');
// Navigator.pushNamed(context, 'test state');
},
然后热重载,控制台日志输出:
I/flutter (22202): reassemble
I/flutter (22202): deactivate
I/flutter (22202): dispose
由此可知,在CounterWidget从widget树中移除时,deactivate和dispose会依次被调用