MaterialApp 代表使用紙墨設(shè)計(jì)(Material Design)風(fēng)格的應(yīng)用毒姨。里面包含了紙墨設(shè)計(jì)風(fēng)格應(yīng)用所需要的基本控件。
MaterialApp 主要屬性如下:
- title : 在任務(wù)管理窗口中所顯示的應(yīng)用名字
- theme : 應(yīng)用各種 UI 所使用的主題顏色
- color : 應(yīng)用的主要顏色值(primary color)胳蛮,也就是安卓任務(wù)管理窗口中所顯示的應(yīng)用顏色
- home : 應(yīng)用默認(rèn)所顯示的界面 Widget
- routes : 應(yīng)用的頂級(jí)導(dǎo)航表格坐慰,這個(gè)是多頁(yè)面應(yīng)用用來(lái)控制頁(yè)面跳轉(zhuǎn)的谭期,類(lèi)似于網(wǎng)頁(yè)的網(wǎng)址
- initialRoute :第一個(gè)顯示的路由名字饱亮,默認(rèn)值為 Navigator.defaultRouteName
- onGenerateRoute : 生成路由的回調(diào)函數(shù),當(dāng)導(dǎo)航的命名路由的時(shí)候脖岛,會(huì)使用這個(gè)來(lái)生成界面
- onLocaleChanged : 當(dāng)系統(tǒng)修改語(yǔ)言的時(shí)候朵栖,會(huì)觸發(fā)這個(gè)回調(diào)
- navigatorObservers : 應(yīng)用 Navigator 的監(jiān)聽(tīng)器
- debugShowMaterialGrid : 是否顯示 紙墨設(shè)計(jì) 基礎(chǔ)布局網(wǎng)格,用來(lái)調(diào)試 UI 的工具
- showPerformanceOverlay : 顯示性能標(biāo)簽
- debugShowCheckedModeBanner :是否顯示右上角DEBUG標(biāo)簽 (調(diào)試開(kāi)關(guān))
- checkerboardRasterCacheImages :檢查緩存的圖像開(kāi)關(guān)柴梆,檢測(cè)在界面重繪時(shí)頻繁閃爍的圖像(調(diào)試開(kāi)關(guān))
- showSemanticsDebugger :是否打開(kāi)Widget邊框混槐,類(lèi)似Android開(kāi)發(fā)者模式中顯示布局邊界(調(diào)試開(kāi)關(guān))
下面將介紹重要的幾個(gè)屬性。
title
這個(gè)和啟動(dòng)圖標(biāo)名字是不一樣的轩性,和當(dāng)前 Activity 的名字也是不一樣的。 這個(gè) Title 是用來(lái)定義任務(wù)管理窗口界面所看到應(yīng)用名字的。在原生 Android 系統(tǒng)中點(diǎn)擊圓圈 Home 按鈕右邊的方塊按鈕就會(huì)打開(kāi)多任務(wù)切換窗口揣苏。
theme
定義應(yīng)用所使用的主題顏色悯嗓,在紙墨設(shè)計(jì)中定義了 primaryColor、accentColor卸察、hintColor 等顏色值脯厨。可以通過(guò)這個(gè)來(lái)指定一個(gè) ThemeData 定義應(yīng)用中每個(gè)控件的顏色坑质。
home
這個(gè)是一個(gè) Widget 對(duì)象合武,用來(lái)定義當(dāng)前應(yīng)用打開(kāi)的時(shí)候,所顯示的界面涡扼。
color
定義系統(tǒng)中該應(yīng)用的主要顏色
routes
定義應(yīng)用中頁(yè)面跳轉(zhuǎn)規(guī)則稼跳。 該對(duì)象是一個(gè) Map<String, WidgetBuilder>。
當(dāng)使用 Navigator.pushNamed 來(lái)路由的時(shí)候吃沪,會(huì)在 routes 查找路由名字汤善,然后使用 對(duì)應(yīng)的 WidgetBuilder 來(lái)構(gòu)造一個(gè)帶有頁(yè)面切換動(dòng)畫(huà)的 MaterialPageRoute。如果應(yīng)用只有一個(gè)界面票彪,則不用設(shè)置這個(gè)屬性红淡,使用 home 設(shè)置這個(gè)界面即可。
'/' 和 home 屬性
路由表(也就是我們下面代碼里面定義的routes變量)里面的 '/' 和 home 屬性降铸,二者不能同時(shí)存在在旱,但是必須有一個(gè)存在:
class MyApp extends StatelessWidget {
final Map<String, WidgetBuilder> _routes = <String, WidgetBuilder>{
Navigator.defaultRouteName : (context) => new MyHomePage(title: 'Flutter Demo Home Page') //默認(rèn)路由
};
// This widget is the root of your application.
@override
Widget build(BuildContext context) {
return new MaterialApp(
title: 'Flutter App',
debugShowMaterialGrid: true,
routes: _routes, // 使用 _routes 中定義的 默認(rèn)路由來(lái)替代 home
//home: new MyHomePage(title: 'Flutter Demo Home Page'), //去掉這里的注釋?zhuān)瑒t需要將_routes里面的默認(rèn)路由刪掉
);
}
}
修改了 title、home 被注釋了使用 routes 來(lái)替代推掸。
如果所查找的路由在 routes 中不存在桶蝎,則會(huì)通過(guò) onGenerateRoute 來(lái)查找。
initialRoute
是啟動(dòng)APP的初始頁(yè)面终佛,也就是用戶(hù)看到的第一個(gè)頁(yè)面俊嗽。如果這個(gè)屬性沒(méi)有給值,那么會(huì)去尋找路由表里面的 '/' 铃彰,或者 home 屬性绍豁。
當(dāng)initialRoute沒(méi)有設(shè)置
initialRoute 或者 home 屬性都是定義了主頁(yè)面,當(dāng) initialRoute 沒(méi)有定義的時(shí)候牙捉,用戶(hù)看到的就是 '/' 或者 home 對(duì)應(yīng)的頁(yè)面竹揍。
當(dāng)initialRoute設(shè)置了
當(dāng)initialRoute 和 '/' 或者 home 屬性同時(shí)存在的時(shí)候,initialRoute 的優(yōu)先級(jí)高于二者邪铲。意思就是如果 initialRoute 定義的頁(yè)面和 '/' 或者 home 設(shè)置的頁(yè)面不同時(shí)芬位,用戶(hù)看到的是 initialRoute 定義的頁(yè)面。
onGenerateRoute
路由回調(diào)函數(shù)带到,在打開(kāi)命名路由的時(shí)候可能會(huì)被調(diào)用昧碉,之所以說(shuō)可能,是因?yàn)楫?dāng)調(diào)用Navigator.pushNamed(...)打開(kāi)命名路由時(shí),如果指定的路有名在路由表中已注冊(cè)被饿,則回調(diào)用路由表中的builder函數(shù)來(lái)生成路由組建四康;如果路由表中沒(méi)有注冊(cè),則會(huì)調(diào)用onGenerateRoute來(lái)生成路由狭握。
假設(shè)我們需要開(kāi)發(fā)一個(gè)電商APP闪金,當(dāng)用戶(hù)沒(méi)有登錄的時(shí)候可以查看碘伏、商品等信息论颅,但是交易記錄哎垦、購(gòu)物車(chē)、用戶(hù)個(gè)人信息等頁(yè)面需要登錄后才能查看恃疯。就可以在onGenerateRoute回調(diào)中進(jìn)行統(tǒng)一的權(quán)限控制:
MaterialApp(
... //省略無(wú)關(guān)代碼
onGenerateRoute: (RouteSettings settings){
return MaterialPageRoute(settings: settings, builder: (BuildContext context) {
String routeName = settings.name;
//如果訪問(wèn)的路由頁(yè)需要登錄漏设,但當(dāng)前未登錄,則這里直接返回登錄頁(yè)路由澡谭,引導(dǎo)用戶(hù)登錄愿题;其他情況下則是正常打開(kāi)路由
});
},
);