在前面的介紹中,我們知道在 Flutter 中幾乎所有的對(duì)象都是一個(gè)Widget。與原生開(kāi)發(fā)中“控件”不同的是,F(xiàn)lutter 中的 Widget 的概念更廣泛,它不僅可以表示 UI 元素,也可以表示一些功能性的組件如:用于手勢(shì)檢測(cè)的 GestureDetector
widget、用于 APP 主題數(shù)據(jù)傳遞的Theme
等等,而原生開(kāi)發(fā)中的控件通常只是指 UI 元素。在后面的內(nèi)容中,我們?cè)诿枋?UI 元素時(shí)可能會(huì)用到“控件”、“組件”這樣的概念,讀者心里需要知道他們就是 widget,只是在不同場(chǎng)景的不同表述而已。由于 Flutter 主要就是用于構(gòu)建用戶界面的,所以,在大多數(shù)時(shí)候,讀者可以認(rèn)為 widget 就是一個(gè)控件,不必糾結(jié)于概念。
在 Flutter 中,Widget 的功能是“描述一個(gè) UI 元素的配置數(shù)據(jù)”,它就是說(shuō),Widget 其實(shí)并不是表示最終繪制在設(shè)備屏幕上的顯示元素,而它只是描述顯示元素的一個(gè)配置數(shù)據(jù)。
實(shí)際上,F(xiàn)lutter 中真正代表屏幕上顯示元素的類是Element
,也就是說(shuō) Widget 只是描述Element
的配置數(shù)據(jù)!有關(guān)Element
的詳細(xì)介紹我們將在本書后面的高級(jí)部分深入介紹,現(xiàn)在,讀者只需要知道:Widget 只是 UI 元素的一個(gè)配置數(shù)據(jù),并且一個(gè) Widget 可以對(duì)應(yīng)多個(gè)Element
。這是因?yàn)橥粋€(gè) Widget 對(duì)象可以被添加到 U 樹的不同部分,而真正渲染時(shí),UI樹的每一個(gè)Element
節(jié)點(diǎn)都會(huì)對(duì)應(yīng)一個(gè) Widget 對(duì)象??偨Y(jié)一下:
Element
的配置數(shù)據(jù),Widget 樹實(shí)際上是一個(gè)配置樹,而真正的 UI 渲染樹是由Element
構(gòu)成;不過(guò),由于Element
是通過(guò) Widget 生成的,所以它們之間有對(duì)應(yīng)關(guān)系,在大多數(shù)場(chǎng)景,我們可以寬泛地認(rèn)為 Widget 樹就是指 UI 控件樹或 UI 渲染樹。Element
對(duì)象。這很好理解,根據(jù)同一份配置(Widget),可以創(chuàng)建多個(gè)實(shí)例(Element)。讀者應(yīng)該將這兩點(diǎn)牢記在心中。
我們先來(lái)看一下Widget類的聲明:
@immutable
abstract class Widget extends DiagnosticableTree {
const Widget({ this.key });
final Key key;
@protected
Element createElement();
@override
String toStringShort() {
return key == null ? '$runtimeType' : '$runtimeType-$key';
}
@override
void debugFillProperties(DiagnosticPropertiesBuilder properties) {
super.debugFillProperties(properties);
properties.defaultDiagnosticsTreeStyle = DiagnosticsTreeStyle.dense;
}
static bool canUpdate(Widget oldWidget, Widget newWidget) {
return oldWidget.runtimeType == newWidget.runtimeType
&& oldWidget.key == newWidget.key;
}
}
Widget
類繼承自DiagnosticableTree
,DiagnosticableTree
即“診斷樹”,主要作用是提供調(diào)試信息。Key
: 這個(gè)key
屬性類似于 React/Vue 中的key
,主要的作用是決定是否在下一次build
時(shí)復(fù)用舊的 widget,決定的條件在canUpdate()
方法中。createElement()
:正如前文所述“一個(gè) Widget 可以對(duì)應(yīng)多個(gè)Element
”;Flutter Framework 在構(gòu)建 UI 樹時(shí),會(huì)先調(diào)用此方法生成對(duì)應(yīng)節(jié)點(diǎn)的Element
對(duì)象。此方法是 Flutter Framework 隱式調(diào)用的,在我們開(kāi)發(fā)過(guò)程中基本不會(huì)調(diào)用到。debugFillProperties(...)
復(fù)寫父類的方法,主要是設(shè)置診斷樹的一些特性。canUpdate(...)
是一個(gè)靜態(tài)方法,它主要用于在 Widget 樹重新build
時(shí)復(fù)用舊的 widget,其實(shí)具體來(lái)說(shuō),應(yīng)該是:是否用新的Widget對(duì)象去更新舊 UI 樹上所對(duì)應(yīng)的Element
對(duì)象的配置;通過(guò)其源碼我們可以看到,只要newWidget
與oldWidget
的runtimeType
和key
同時(shí)相等時(shí)就會(huì)用newWidget
去更新Element
對(duì)象的配置,否則就會(huì)創(chuàng)建新的Element
。有關(guān) Key 和 Widget 復(fù)用的細(xì)節(jié)將會(huì)在本書后面高級(jí)部分深入討論,讀者現(xiàn)在只需知道,為 Widget 顯式添加 key 的話可能(但不一定)會(huì)使UI在重新構(gòu)建時(shí)變的高效,讀者目前可以先忽略此參數(shù)。本書后面的示例中,只會(huì)在構(gòu)建列表項(xiàng) UI 時(shí)會(huì)顯式指定 Key。
另外Widget
類本身是一個(gè)抽象類,其中最核心的就是定義了createElement()
接口,在 Flutter 開(kāi)發(fā)中,我們一般都不用直接繼承Widget
類來(lái)實(shí)現(xiàn)一個(gè)新組件,相反,我們通常會(huì)通過(guò)繼承StatelessWidget
或StatefulWidget
來(lái)間接繼承Widget
類來(lái)實(shí)現(xiàn)。StatelessWidget
和StatefulWidget
都是直接繼承自Widget
類,而這兩個(gè)類也正是 Flutter 中非常重要的兩個(gè)抽象類,它們引入了兩種 Widget 模型,接下來(lái)我們將重點(diǎn)介紹一下這兩個(gè)類。
在之前的章節(jié)中,我們已經(jīng)簡(jiǎn)單介紹過(guò)StatelessWidget
,StatelessWidget
相對(duì)比較簡(jiǎn)單,它繼承自Widget
類,重寫了createElement()
方法:
@override
StatelessElement createElement() => new StatelessElement(this);
StatelessElement
間接繼承自Element
類,與StatelessWidget
相對(duì)應(yīng)(作為其配置數(shù)據(jù))。
StatelessWidget
用于不需要維護(hù)狀態(tài)的場(chǎng)景,它通常在build
方法中通過(guò)嵌套其它 Widget 來(lái)構(gòu)建UI,在構(gòu)建過(guò)程中會(huì)遞歸的構(gòu)建其嵌套的 Widget。我們看一個(gè)簡(jiǎn)單的例子:
class Echo extends StatelessWidget {
const Echo({
Key key,
@required this.text,
this.backgroundColor:Colors.grey,
}):super(key:key);
final String text;
final Color backgroundColor;
@override
Widget build(BuildContext context) {
return Center(
child: Container(
color: backgroundColor,
child: Text(text),
),
);
}
}
上面的代碼,實(shí)現(xiàn)了一個(gè)回顯字符串的Echo
widget。
按照慣例,
widget
的構(gòu)造函數(shù)參數(shù)應(yīng)使用命名參數(shù),命名參數(shù)中的必要參數(shù)要添加@required
標(biāo)注,這樣有利于靜態(tài)代碼分析器進(jìn)行檢查。另外,在繼承widget
時(shí),第一個(gè)參數(shù)通常應(yīng)該是Key
,另外,如果 Widget 需要接收子 Widget,那么child
或children
參數(shù)通常應(yīng)被放在參數(shù)列表的最后。同樣是按照慣例,Widget 的屬性應(yīng)盡可能的被聲明為final
,防止被意外改變。
然后我們可以通過(guò)如下方式使用它:
Widget build(BuildContext context) {
return Echo(text: "hello world");
}
運(yùn)行后效果如圖3-1所示:
build
方法有一個(gè)context
參數(shù),它是BuildContext
類的一個(gè)實(shí)例,表示當(dāng)前 widget 在 widget 樹中的上下文,每一個(gè) widget 都會(huì)對(duì)應(yīng)一個(gè) context 對(duì)象(因?yàn)槊恳粋€(gè) widget 都是 widget 樹上的一個(gè)節(jié)點(diǎn))。實(shí)際上,context
是當(dāng)前 widget 在 widget 樹中位置中執(zhí)行”相關(guān)操作“的一個(gè)句柄,比如它提供了從當(dāng)前 widget 開(kāi)始向上遍歷 widget 樹以及按照 widget 類型查找父級(jí) widget 的方法。下面是在子樹中獲取父級(jí) widget 的一個(gè)示例:
class ContextRoute extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text("Context測(cè)試"),
),
body: Container(
child: Builder(builder: (context) {
// 在Widget樹中向上查找最近的父級(jí)`Scaffold` widget
Scaffold scaffold = context.findAncestorWidgetOfExactType<Scaffold>();
// 直接返回 AppBar的title, 此處實(shí)際上是Text("Context測(cè)試")
return (scaffold.appBar as AppBar).title;
}),
),
);
}
}
運(yùn)行后效果如圖3-1-1所示:
注意:對(duì)于
BuildContext
讀者現(xiàn)在可以先作了解,隨著本書后面內(nèi)容的展開(kāi),也會(huì)用到Context的一些方法,讀者可以通過(guò)具體的場(chǎng)景對(duì)其有個(gè)直觀的認(rèn)識(shí)。關(guān)于BuildContext
更多的內(nèi)容,我們也將在后面高級(jí)部分再深入介紹。
和StatelessWidget
一樣,StatefulWidget
也是繼承自Widget
類,并重寫了createElement()
方法,不同的是返回的Element
對(duì)象并不相同;另外StatefulWidget
類中添加了一個(gè)新的接口createState()
。
下面我們看看StatefulWidget
的類定義:
abstract class StatefulWidget extends Widget {
const StatefulWidget({ Key key }) : super(key: key);
@override
StatefulElement createElement() => new StatefulElement(this);
@protected
State createState();
}
StatefulElement
間接繼承自Element
類,與 StatefulWidget 相對(duì)應(yīng)(作為其配置數(shù)據(jù))。StatefulElement
中可能會(huì)多次調(diào)用createState()
來(lái)創(chuàng)建狀態(tài)(State)對(duì)象。createState()
用于創(chuàng)建和 Stateful widget 相關(guān)的狀態(tài),它在 Stateful widget 的生命周期中可能會(huì)被多次調(diào)用。例如,當(dāng)一個(gè) Stateful widget 同時(shí)插入到 widget 樹的多個(gè)位置時(shí),F(xiàn)lutter framework 就會(huì)調(diào)用該方法為每一個(gè)位置生成一個(gè)獨(dú)立的 State 實(shí)例,其實(shí),本質(zhì)上就是一個(gè)StatefulElement
對(duì)應(yīng)一個(gè) State 實(shí)例。在本書中經(jīng)常會(huì)出現(xiàn)“樹”的概念,在不同的場(chǎng)景可能指不同的意思,在說(shuō)“widget 樹”時(shí)它可以指 widget 結(jié)構(gòu)樹,但由于 widget 與 Element 有對(duì)應(yīng)關(guān)系(一可能對(duì)多),在有些場(chǎng)景(Flutter 的 SDK 文檔中)也代指“UI 樹”的意思。而在 stateful widget 中,State 對(duì)象也和
StatefulElement
具有對(duì)應(yīng)關(guān)系(一對(duì)一),所以在 Flutter 的 SDK 文檔中,可以經(jīng)??吹健皬臉渲幸瞥?State 對(duì)象”或“插入 State 對(duì)象到樹中”這樣的描述。其實(shí),無(wú)論哪種描述,其意思都是在描述“一棵構(gòu)成用戶界面的節(jié)點(diǎn)元素的樹”,讀者不必糾結(jié)于這些概念,還是那句話“得其神,忘其形”,因此,本書中出現(xiàn)的各種“樹”,如果沒(méi)有特別說(shuō)明,讀者都可抽象的認(rèn)為它是“一棵構(gòu)成用戶界面的節(jié)點(diǎn)元素的樹”。
一個(gè) StatefulWidget 類會(huì)對(duì)應(yīng)一個(gè) State 類,State 表示與其對(duì)應(yīng)的 StatefulWidget 要維護(hù)的狀態(tài), State 中的保存的狀態(tài)信息可以:
setState()
方法通知 Flutter framework 狀態(tài)發(fā)生改變,F(xiàn)lutter framework 在收到消息后,會(huì)重新調(diào)用其build
方法重新構(gòu)建 widget 樹,從而達(dá)到更新 UI 的目的。State中有兩個(gè)常用屬性:
widget
,它表示與該 State 實(shí)例關(guān)聯(lián)的 widget 實(shí)例,由 Flutter framework 動(dòng)態(tài)設(shè)置。注意,這種關(guān)聯(lián)并非永久的,因?yàn)樵趹?yīng)用生命周期中,UI 樹上的某一個(gè)節(jié)點(diǎn)的 widget 實(shí)例在重新構(gòu)建時(shí)可能會(huì)變化,但 State 實(shí)例只會(huì)在第一次插入到樹中時(shí)被創(chuàng)建,當(dāng)在重新構(gòu)建時(shí),如果 widget 被修改了,F(xiàn)lutter framework 會(huì)動(dòng)態(tài)設(shè)置 State.widget 為新的 widget 實(shí)例。context
。StatefulWidget 對(duì)應(yīng)的 BuildContext,作用同 StatelessWidget 的 BuildContext。理解 State 的生命周期對(duì) flutter 開(kāi)發(fā)非常重要,為了加深讀者印象,本節(jié)我們通過(guò)一個(gè)實(shí)例來(lái)演示一下 State 的生命周期。在接下來(lái)的示例中,我們實(shí)現(xiàn)一個(gè)計(jì)數(shù)器 widget,點(diǎn)擊它可以使計(jì)數(shù)器加1,由于要保存計(jì)數(shù)器的數(shù)值狀態(tài),所以我們應(yīng)繼承 StatefulWidget,代碼如下:
class CounterWidget extends StatefulWidget {
const CounterWidget({
Key key,
this.initValue: 0
});
final int initValue;
@override
_CounterWidgetState createState() => new _CounterWidgetState();
}
CounterWidget
接收一個(gè)initValue
整型參數(shù),它表示計(jì)數(shù)器的初始值。下面我們看一下 State 的代碼:
class _CounterWidgetState extends State<CounterWidget> {
int _counter;
@override
void initState() {
super.initState();
//初始化狀態(tài)
_counter=widget.initValue;
print("initState");
}
@override
Widget build(BuildContext context) {
print("build");
return Scaffold(
body: Center(
child: FlatButton(
child: Text('$_counter'),
//點(diǎn)擊后計(jì)數(shù)器自增
onPressed:()=>setState(()=> ++_counter,
),
),
),
);
}
@override
void didUpdateWidget(CounterWidget oldWidget) {
super.didUpdateWidget(oldWidget);
print("didUpdateWidget");
}
@override
void deactivate() {
super.deactivate();
print("deactive");
}
@override
void dispose() {
super.dispose();
print("dispose");
}
@override
void reassemble() {
super.reassemble();
print("reassemble");
}
@override
void didChangeDependencies() {
super.didChangeDependencies();
print("didChangeDependencies");
}
}
接下來(lái),我們創(chuàng)建一個(gè)新路由,在新路由中,我們只顯示一個(gè)CounterWidget
:
Widget build(BuildContext context) {
return CounterWidget();
}
我們運(yùn)行應(yīng)用并打開(kāi)該路由頁(yè)面,在新路由頁(yè)打開(kāi)后,屏幕中央就會(huì)出現(xiàn)一個(gè)數(shù)字0,然后控制臺(tái)日志輸出:
I/flutter ( 5436): initState
I/flutter ( 5436): didChangeDependencies
I/flutter ( 5436): build
可以看到,在 StatefulWidget 插入到 Widget 樹時(shí)首先initState
方法會(huì)被調(diào)用。
然后我們點(diǎn)擊??按鈕熱重載,控制臺(tái)輸出日志如下:
I/flutter ( 5436): reassemble
I/flutter ( 5436): didUpdateWidget
I/flutter ( 5436): build
可以看到此時(shí)initState
和didChangeDependencies
都沒(méi)有被調(diào)用,而此時(shí)didUpdateWidget
被調(diào)用。
接下來(lái),我們?cè)?widget 樹中移除CounterWidget
,將路由build
方法改為:
Widget build(BuildContext context) {
//移除計(jì)數(shù)器
//return CounterWidget();
//隨便返回一個(gè)Text()
return Text("xxx");
}
然后熱重載,日志如下:
I/flutter ( 5436): reassemble
I/flutter ( 5436): deactive
I/flutter ( 5436): dispose
我們可以看到,在CounterWidget
從 widget 樹中移除時(shí),deactive
和dispose
會(huì)依次被調(diào)用。
下面我們來(lái)看看各個(gè)回調(diào)函數(shù):
initState
:當(dāng) Widget 第一次插入到 Widget 樹時(shí)會(huì)被調(diào)用,對(duì)于每一個(gè) State 對(duì)象,F(xiàn)lutter framework 只會(huì)調(diào)用一次該回調(diào),所以,通常在該回調(diào)中做一些一次性的操作,如狀態(tài)初始化、訂閱子樹的事件通知等。不能在該回調(diào)中調(diào)用BuildContext.dependOnInheritedWidgetOfExactType
(該方法用于在 Widget 樹上獲取離當(dāng)前 widget 最近的一個(gè)父級(jí)InheritFromWidget
,關(guān)于InheritedWidget
我們將在后面章節(jié)介紹),原因是在初始化完成后,Widget 樹中的InheritFromWidget
也可能會(huì)發(fā)生變化,所以正確的做法應(yīng)該在在build()
方法或didChangeDependencies()
中調(diào)用它。didChangeDependencies()
:當(dāng) State 對(duì)象的依賴發(fā)生變化時(shí)會(huì)被調(diào)用;例如:在之前build()
中包含了一個(gè)InheritedWidget
,然后在之后的build()
中InheritedWidget
發(fā)生了變化,那么此時(shí)InheritedWidget
的子 widget 的didChangeDependencies()
回調(diào)都會(huì)被調(diào)用。典型的場(chǎng)景是當(dāng)系統(tǒng)語(yǔ)言 Locale 或應(yīng)用主題改變時(shí),F(xiàn)lutter framework 會(huì)通知 widget 調(diào)用此回調(diào)。build()
:此回調(diào)讀者現(xiàn)在應(yīng)該已經(jīng)相當(dāng)熟悉了,它主要是用于構(gòu)建 Widget 子樹的,會(huì)在如下場(chǎng)景被調(diào)用:
initState()
之后。didUpdateWidget()
之后。setState()
之后。didChangeDependencies()
之后。reassemble()
:此回調(diào)是專門為了開(kāi)發(fā)調(diào)試而提供的,在熱重載(hot reload)時(shí)會(huì)被調(diào)用,此回調(diào)在Release模式下永遠(yuǎn)不會(huì)被調(diào)用。didUpdateWidget()
:在 widget 重新構(gòu)建時(shí),F(xiàn)lutter framework 會(huì)調(diào)用Widget.canUpdate
來(lái)檢測(cè) Widget 樹中同一位置的新舊節(jié)點(diǎn),然后決定是否需要更新,如果Widget.canUpdate
返回true
則會(huì)調(diào)用此回調(diào)。正如之前所述,Widget.canUpdate
會(huì)在新舊widget的key和runtimeType 同時(shí)相等時(shí)會(huì)返回true,也就是說(shuō)在在新舊 widget 的 key 和 runtimeType 同時(shí)相等時(shí)didUpdateWidget()
就會(huì)被調(diào)用。deactivate()
:當(dāng) State 對(duì)象從樹中被移除時(shí),會(huì)調(diào)用此回調(diào)。在一些場(chǎng)景下,F(xiàn)lutter framework 會(huì)將 State 對(duì)象重新插到樹中,如包含此 State 對(duì)象的子樹在樹的一個(gè)位置移動(dòng)到另一個(gè)位置時(shí)(可以通過(guò) GlobalKey 來(lái)實(shí)現(xiàn))。如果移除后沒(méi)有重新插入到樹中則緊接著會(huì)調(diào)用dispose()
方法。dispose()
:當(dāng) State 對(duì)象從樹中被永久移除時(shí)調(diào)用;通常在此回調(diào)中釋放資源。StatefulWidget 生命周期如圖3-2所示:
注意:在繼承
StatefulWidget
重寫其方法時(shí),對(duì)于包含@mustCallSuper
標(biāo)注的父類方法,都要在子類方法中先調(diào)用父類方法。
現(xiàn)在,我們回答之前提出的問(wèn)題,為什么build()
方法放在 State(而不是StatefulWidget
)中 ?這主要是為了提高開(kāi)發(fā)的靈活性。如果將build()
方法在StatefulWidget
中則會(huì)有兩個(gè)問(wèn)題:
試想一下,如果我們的StatefulWidget
有很多狀態(tài),而每次狀態(tài)改變都要調(diào)用build
方法,由于狀態(tài)是保存在 State 中的,如果build
方法在StatefulWidget
中,那么build
方法和狀態(tài)分別在兩個(gè)類中,那么構(gòu)建時(shí)讀取狀態(tài)將會(huì)很不方便!試想一下,如果真的將build
方法放在 StatefulWidget 中的話,由于構(gòu)建用戶界面過(guò)程需要依賴 State,所以build
方法將必須加一個(gè)State
參數(shù),大概是下面這樣:
Widget build(BuildContext context, State state){
//state.counter
...
}
這樣的話就只能將 State 的所有狀態(tài)聲明為公開(kāi)的狀態(tài),這樣才能在 State 類外部訪問(wèn)狀態(tài)!但是,將狀態(tài)設(shè)置為公開(kāi)后,狀態(tài)將不再具有私密性,這就會(huì)導(dǎo)致對(duì)狀態(tài)的修改將會(huì)變的不可控。但如果將build()
方法放在 State 中的話,構(gòu)建過(guò)程不僅可以直接訪問(wèn)狀態(tài),而且也無(wú)需公開(kāi)私有狀態(tài),這會(huì)非常方便。
StatefulWidget
不便。
例如,F(xiàn)lutter 中有一個(gè)動(dòng)畫 widget 的基類AnimatedWidget
,它繼承自StatefulWidget
類。AnimatedWidget
中引入了一個(gè)抽象方法build(BuildContext context)
,繼承自AnimatedWidget
的動(dòng)畫widget都要實(shí)現(xiàn)這個(gè)build
方法?,F(xiàn)在設(shè)想一下,如果StatefulWidget
類中已經(jīng)有了一個(gè)build
方法,正如上面所述,此時(shí)build
方法需要接收一個(gè)state對(duì)象,這就意味著AnimatedWidget
必須將自己的 State 對(duì)象(記為_(kāi)animatedWidgetState)提供給其子類,因?yàn)樽宇愋枰谄?code>build方法中調(diào)用父類的build
方法,代碼可能如下:
class MyAnimationWidget extends AnimatedWidget{
@override
Widget build(BuildContext context, State state){
//由于子類要用到AnimatedWidget的狀態(tài)對(duì)象_animatedWidgetState,
//所以AnimatedWidget必須通過(guò)某種方式將其狀態(tài)對(duì)象_animatedWidgetState
//暴露給其子類
super.build(context, _animatedWidgetState)
}
}
這樣很顯然是不合理的,因?yàn)?/p>
AnimatedWidget
的狀態(tài)對(duì)象是AnimatedWidget
內(nèi)部實(shí)現(xiàn)細(xì)節(jié),不應(yīng)該暴露給外部。
綜上所述,可以發(fā)現(xiàn),對(duì)于StatefulWidget
,將build
方法放在State中,可以給開(kāi)發(fā)帶來(lái)很大的靈活性。
由于 StatefulWidget 的的具體邏輯都在其 State 中,所以很多時(shí)候,我們需要獲取 StatefulWidget 對(duì)應(yīng)的 State 對(duì)象來(lái)調(diào)用一些方法,比如Scaffold
組件對(duì)應(yīng)的狀態(tài)類ScaffoldState
中就定義了打開(kāi) SnackBar(路由頁(yè)底部提示條)的方法。我們有兩種方法在子 widget 樹中獲取父級(jí) StatefulWidget 的 State 對(duì)象。
context
對(duì)象有一個(gè)findAncestorStateOfType()
方法,該方法可以從當(dāng)前節(jié)點(diǎn)沿著 widget 樹向上查找指定類型的 StatefulWidget 對(duì)應(yīng)的 State 對(duì)象。下面是實(shí)現(xiàn)打開(kāi) SnackBar 的示例:
Scaffold(
appBar: AppBar(
title: Text("子樹中獲取State對(duì)象"),
),
body: Center(
child: Builder(builder: (context) {
return RaisedButton(
onPressed: () {
// 查找父級(jí)最近的Scaffold對(duì)應(yīng)的ScaffoldState對(duì)象
ScaffoldState _state = context.findAncestorStateOfType<ScaffoldState>();
//調(diào)用ScaffoldState的showSnackBar來(lái)彈出SnackBar
_state.showSnackBar(
SnackBar(
content: Text("我是SnackBar"),
),
);
},
child: Text("顯示SnackBar"),
);
}),
),
);
上面示例運(yùn)行后,點(diǎn)擊”顯示 SnackBar“,效果如圖3-1-2所示:
一般來(lái)說(shuō),如果 StatefulWidget 的狀態(tài)是私有的(不應(yīng)該向外部暴露),那么我們代碼中就不應(yīng)該去直接獲取其 State 對(duì)象;如果 StatefulWidget 的狀態(tài)是希望暴露出的(通常還有一些組件的操作方法),我們則可以去直接獲取其 State 對(duì)象。但是通過(guò)context.findAncestorStateOfType
獲取 StatefulWidget 的狀態(tài)的方法是通用的,我們并不能在語(yǔ)法層面指定 StatefulWidget 的狀態(tài)是否私有,所以在 Flutter 開(kāi)發(fā)中便有了一個(gè)默認(rèn)的約定:如果 StatefulWidget 的狀態(tài)是希望暴露出的,應(yīng)當(dāng)在 StatefulWidget 中提供一個(gè)of
靜態(tài)方法來(lái)獲取其 State 對(duì)象,開(kāi)發(fā)者便可直接通過(guò)該方法來(lái)獲??;如果 State 不希望暴露,則不提供of
方法。這個(gè)約定在 Flutter SDK 里隨處可見(jiàn)。所以,上面示例中的Scaffold
也提供了一個(gè)of
方法,我們其實(shí)是可以直接調(diào)用它的:
...//省略無(wú)關(guān)代碼
// 直接通過(guò)of靜態(tài)方法來(lái)獲取ScaffoldState
ScaffoldState _state=Scaffold.of(context);
_state.showSnackBar(
SnackBar(
content: Text("我是SnackBar"),
),
);
Flutter 還有一種通用的獲取State
對(duì)象的方法——通過(guò) GlobalKey 來(lái)獲取! 步驟分兩步:
StatefulWidget
添加GlobalKey
。 //定義一個(gè)globalKey, 由于GlobalKey要保持全局唯一性,我們使用靜態(tài)變量存儲(chǔ)
static GlobalKey<ScaffoldState> _globalKey= GlobalKey();
...
Scaffold(
key: _globalKey , //設(shè)置key
...
)
GlobalKey
來(lái)獲取State
對(duì)象
_globalKey.currentState.openDrawer()
GlobalKe y是 Flutter 提供的一種在整個(gè) APP 中引用 element 的機(jī)制。如果一個(gè) widget 設(shè)置了GlobalKey
,那么我們便可以通過(guò)globalKey.currentWidget
獲得該 widget對(duì)象、globalKey.currentElement
來(lái)獲得widget對(duì)應(yīng)的element對(duì)象,如果當(dāng)前 widget 是StatefulWidget
,則可以通過(guò)globalKey.currentState
來(lái)獲得該 widget 對(duì)應(yīng)的 state 對(duì)象。
注意:使用 GlobalKey 開(kāi)銷較大,如果有其他可選方案,應(yīng)盡量避免使用它。另外同一個(gè)GlobalKey 在整個(gè) widget 樹中必須是唯一的,不能重復(fù)。
Flutter 提供了一套豐富、強(qiáng)大的基礎(chǔ)組件,在基礎(chǔ)組件庫(kù)之上 Flutter 又提供了一套 Material 風(fēng)格(Android 默認(rèn)的視覺(jué)風(fēng)格)和一套 Cupertino 風(fēng)格(iOS 視覺(jué)風(fēng)格)的組件庫(kù)。要使用基礎(chǔ)組件庫(kù),需要先導(dǎo)入:
import 'package:flutter/widgets.dart';
下面我們介紹一下常用的組件。
Text
(opens new window):該組件可讓您創(chuàng)建一個(gè)帶格式的文本。Row
(opens new window)、 Column
(opens new window): 這些具有彈性空間的布局類 Widget 可讓您在水平(Row)和垂直(Column)方向上創(chuàng)建靈活的布局。其設(shè)計(jì)是基于Web開(kāi)發(fā)中的 Flexbox 布局模型。Stack
(opens new window): 取代線性布局 (譯者語(yǔ):和 Android 中的FrameLayout
相似),Stack
(opens new window)允許子 widget 堆疊, 你可以使用 Positioned
(opens new window)來(lái)定位他們相對(duì)于Stack
的上下左右四條邊的位置。Stacks 是基于 Web 開(kāi)發(fā)中的絕對(duì)定位(absolute positioning )布局模型設(shè)計(jì)的。Container
(opens new window): Container
(opens new window)可讓您創(chuàng)建矩形視覺(jué)元素。container 可以裝飾一個(gè)BoxDecoration
(opens new window), 如 background、一個(gè)邊框、或者一個(gè)陰影。 Container
(opens new window)也可以具有邊距(margins)、填充(padding)和應(yīng)用于其大小的約束(constraints)。另外, Container
(opens new window)可以使用矩陣在三維空間中對(duì)其進(jìn)行變換。
Flutter 提供了一套豐富的 Material 組件,它可以幫助我們構(gòu)建遵循 Material Design 設(shè)計(jì)規(guī)范的應(yīng)用程序。Material 應(yīng)用程序以MaterialApp
(opens new window) 組件開(kāi)始, 該組件在應(yīng)用程序的根部創(chuàng)建了一些必要的組件,比如Theme
組件,它用于配置應(yīng)用的主題。 是否使用MaterialApp
(opens new window)完全是可選的,但是使用它是一個(gè)很好的做法。在之前的示例中,我們已經(jīng)使用過(guò)多個(gè) Material 組件了,如:Scaffold
、AppBar
、FlatButton
等。要使用 Material 組件,需要先引入它:
import 'package:flutter/material.dart';
Flutter 也提供了一套豐富的 Cupertino 風(fēng)格的組件,盡管目前還沒(méi)有 Material 組件那么豐富,但是它仍在不斷的完善中。值得一提的是在 Material 組件庫(kù)中有一些組件可以根據(jù)實(shí)際運(yùn)行平臺(tái)來(lái)切換表現(xiàn)風(fēng)格,比如MaterialPageRoute
,在路由切換時(shí),如果是 Android 系統(tǒng),它將會(huì)使用 Android 系統(tǒng)默認(rèn)的頁(yè)面切換動(dòng)畫(從底向上);如果是 iOS 系統(tǒng),它會(huì)使用 iOS 系統(tǒng)默認(rèn)的頁(yè)面切換動(dòng)畫(從右向左)。由于在前面的示例中還沒(méi)有 Cupertino 組件的示例,下面我們實(shí)現(xiàn)一個(gè)簡(jiǎn)單的 Cupertino 組件風(fēng)格的頁(yè)面:
//導(dǎo)入cupertino widget庫(kù)
import 'package:flutter/cupertino.dart';
class CupertinoTestRoute extends StatelessWidget {
@override
Widget build(BuildContext context) {
return CupertinoPageScaffold(
navigationBar: CupertinoNavigationBar(
middle: Text("Cupertino Demo"),
),
child: Center(
child: CupertinoButton(
color: CupertinoColors.activeBlue,
child: Text("Press"),
onPressed: () {}
),
),
);
}
}
下面(圖3-3)是在 iPhoneX 上頁(yè)面效果截圖:
本章后面章節(jié)的示例中會(huì)使用一些布局類組件,如Scaffold
、Row
、Column
等,這些組件將在后面“布局類組件”一章中詳細(xì)介紹,讀者可以先不用關(guān)注。
Flutter 提供了豐富的組件,在實(shí)際的開(kāi)發(fā)中你可以根據(jù)需要隨意使用它們,而不必?fù)?dān)心引入過(guò)多組件庫(kù)會(huì)讓你的應(yīng)用安裝包變大,這不是 web 開(kāi)發(fā),dart 在編譯時(shí)只會(huì)編譯你使用了的代碼。由于 Material 和 Cupertino 都是在基礎(chǔ)組件庫(kù)之上的,所以如果我們的應(yīng)用中引入了這兩者之一,則不需要再引入flutter/widgets.dart
了,因?yàn)樗鼈儍?nèi)部已經(jīng)引入過(guò)了。
更多建議: