Flutter開發(fā)之路由與導(dǎo)航的實現(xiàn)
如果說構(gòu)成視圖元素的基本單位是組件,那么構(gòu)成應(yīng)用程序的基本單位就是頁面。對于擁有多個頁面的應(yīng)用程序而言,如何從一個頁面平滑地過渡到另一個頁面,是技術(shù)框架需要考慮的問題。
在前端開發(fā)中,可以使用路由框架來統(tǒng)一管理頁面及它們之間的跳轉(zhuǎn)。在Android中路由指的是一個Activity,在iOS中指的是一個ViewController,可以通過startActivity或pushViewController來打開一個新的路由。在Flutter中,路由的管理和導(dǎo)航借鑒了前端和客戶端的設(shè)計思路,需要使用Route和Navigator來進(jìn)行統(tǒng)一管理。
其中,Route是頁面的抽象,主要負(fù)責(zé)創(chuàng)建界面、接收參數(shù)以及響應(yīng)導(dǎo)航器Navigator的打開與關(guān)閉。而Navigator則用于維護(hù)路由棧管理,Route打開即入棧,Route關(guān)閉即出棧,當(dāng)然還可以替換棧內(nèi)的某一個Route。作為官方提供的路由管理組件,Navigator提供了一系列方法來管理路由棧,其中最常用的兩個方法是push()和pop(),它們的含義如下。
- push():將給定的路由入棧,返回值是一個Future對象,用以接收路由出棧時的返回數(shù)據(jù)。
- pop():將棧頂路由出棧,返回結(jié)果為頁面關(guān)閉時返回給上一個頁面的數(shù)據(jù)。
除了push()和pop()方法外,Navigator還提供了很多其它實用的方法,如replace()、removeRoute()和popUntil()等,可以根據(jù)使用場景合理的選取。
根據(jù)是否需要提前注冊頁面標(biāo)識符,F(xiàn)lutter中的路由管理可以分為基本路由和命名路由兩種。
- 基本路由:無需提前注冊,在頁面切換時需要手動構(gòu)造頁面的實例。
- 命名路由:需要提前注冊頁面標(biāo)識符,在頁面切換時通過標(biāo)識符直接打開新的路由。
下面就讓我們重點(diǎn)來看一下Flutter中的路由管理的基本路由和命名路由等相關(guān)知識。
基本路由
在Flutter開發(fā)中,基本路由的使用方式和原生Android、iOS打開新頁面的方式非常類似。要打開一個新的頁面,只需要創(chuàng)建一個MaterialPageRoute對象實例,然后調(diào)用Navigator.push()方法將新頁面壓到路由堆棧的頂部即可,如果要返回上一個頁面,則可以調(diào)用Navigator.pop()方法。
其中,MaterialPageRoute是一種路由模板,定義了路由創(chuàng)建以及路由切換過渡動畫的相關(guān)配置,該配置可以根據(jù)不同的平臺實現(xiàn)與平臺頁面切換動畫風(fēng)格一致的路由切換動畫。下面是使用Navigator實現(xiàn)頁面跳轉(zhuǎn)的示例,代碼如下。
class FirstPage extends StatelessWidget { @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text('第一個頁面'), ), body: Center( child: RaisedButton( child: Text('跳轉(zhuǎn)到第二個頁面'), onPressed: () => Navigator.push(context, MaterialPageRoute(builder: (context) => SecondPage()))), ), ); } } class SecondPage extends StatelessWidget { @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text('第二個頁面'), ), body: Center( child: RaisedButton( child: Text('返回上一個頁面'), onPressed: () => Navigator.pop(context)), ), ); } }
在上面的示例中,我們創(chuàng)建了兩個頁面,每個頁面都包含一個按鈕。當(dāng)點(diǎn)擊第一個頁面上的按鈕時將導(dǎo)航到第二個頁面,點(diǎn)擊第二個頁面上的按鈕將返回第一個頁面。運(yùn)行上面的代碼,效果如下圖所示。
可以發(fā)現(xiàn),跳轉(zhuǎn)頁面使用的是Navigator.push()方法,該方法可以將一個新的路由添加到由Navigator管理的路由對象的棧頂。而創(chuàng)建新的路由對象使用的是MaterialPageRoute,MaterialPageRoute是PageRoute的子類,定義了路由創(chuàng)建及切換時過渡動畫的相關(guān)接口及屬性,并且自帶頁面切換動畫,Android平臺頁面進(jìn)入動畫是向上滑動并淡出,退出是相反,iOS平臺頁面進(jìn)入動畫是從右側(cè)滑入,退出則相反。
命名路由
基本路由的使用方式相對簡單靈活,適用于應(yīng)用中頁面不多的場景。而對于應(yīng)用中頁面比較多的情況下,如果再使用基本路由方式,那么每次跳轉(zhuǎn)一個新的頁面都要手動創(chuàng)建MaterialPageRoute實例,然后再調(diào)用push()方法來打開一個新的頁面,此時頁面的管理和跳轉(zhuǎn)就比較混亂。
為了避免頻繁的創(chuàng)建MaterialPageRoute實例,F(xiàn)lutter提供了另外一種方式來簡化路由管理,即命名路由。所謂命名路由,就是給頁面起一個別名,然后使用頁面的別名就可以打開它,使用此種方式來管理路由,使得路由的管理更加清晰直觀。
要想通過別名來指定頁面切換,必須先給應(yīng)用程序MaterialApp提供一個頁面名稱映射規(guī)則,即路由表。路由表是一個Map<String,WidgetBuilder>的結(jié)構(gòu),其中key對應(yīng)頁面名字,value則是對應(yīng)的頁面,如下所示。
MaterialApp( ... //其他配置 routes:{ //注冊路由 'first':(context)=>FirstPage(), 'second':(context)=>SecondPage(), }, initialRoute: 'first', //初始路由頁面 );
在路由表中注冊好頁面后,然后就可以通過Navigator.pushNamed()方法來打開頁面,如下所示。
Navigator.pushNamed(context,"second "); // second表示頁面別名
不過,由于路由的注冊和使用都采用字符串來標(biāo)識,這就會帶來一個問題,即如果打開一個不存在的路由頁面。對應(yīng)這類問題,移動應(yīng)用有一個通用的解決方案,即跳轉(zhuǎn)到一個統(tǒng)一的錯誤頁面。在注冊路由表時,F(xiàn)lutter提供了一個UnknownRoute屬性,用來對未知的路由標(biāo)識符進(jìn)行統(tǒng)一的頁面跳轉(zhuǎn)處理,如下所示。
MaterialApp( … routes:{}, onUnknownRoute: (RouteSettings setting) => MaterialPageRoute(builder: (context) => UnknownPage()), //錯誤路由處理,返回UnknownPage ); class UnknownPage extends StatelessWidget { @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text('錯誤路由'), ), ); } }
路由嵌套
有時候,一個應(yīng)用可能不止一個導(dǎo)航器,而是可能有多個導(dǎo)航器,將一個導(dǎo)航器嵌套在另一個導(dǎo)航器的行為稱為路由嵌套。路由嵌套在移動開發(fā)中是很常見的,比如,移動開發(fā)中經(jīng)常會看到應(yīng)用主頁有底部導(dǎo)航欄,每個底部導(dǎo)航欄又嵌套其他頁面的情況,效果如下圖所示。
要實現(xiàn)上面的示例效果,首先需要新建一個底部導(dǎo)航欄,然后再由底部導(dǎo)航欄去嵌套其他子路由。關(guān)于底部導(dǎo)航欄的實現(xiàn),可以直接使用Scaffold布局組件的bottomNavigationBar屬性實現(xiàn),如下所示。
class MainPage extends StatefulWidget { @override State<StatefulWidget> createState() { return MainPageState(); } } class MainPageState extends State<MainPage> { int currentIndex = 0; //底部導(dǎo)航欄索引 final List<Widget> children = [ HomePage(), //首頁 MinePage(), //我的 ]; @override Widget build(BuildContext context) { return Scaffold( body: children[currentIndex], bottomNavigationBar: BottomNavigationBar( onTap: onTabTapped, currentIndex: currentIndex, items: [ BottomNavigationBarItem(icon: Icon(Icons.home), title: Text('首頁')), BottomNavigationBarItem(icon: Icon(Icons.person), title: Text('我的')), ], ), ); } void onTabTapped(int index) { setState(() { currentIndex = index; }); } }
然后,每個底部導(dǎo)航欄會嵌套一個子路由,然后子路由再去管理對應(yīng)的路由頁面。在Flutter中,創(chuàng)建子路由需要使用Navigator組件,并且子路由的攔截需要使用onGenerateRoute屬性,如下所示。
class HomePage extends StatelessWidget { @override Widget build(BuildContext context) { return Navigator( initialRoute: 'first', onGenerateRoute: (RouteSettings settings) { WidgetBuilder builder; switch (settings.name) { case 'first': builder = (BuildContext context) => FirstPage(); break; case 'second': builder = (BuildContext context) => SecondPage(); break; } return new MaterialPageRoute(builder: builder, settings: settings); }, ); } }
運(yùn)行上面的代碼,當(dāng)點(diǎn)擊子路由頁面上的按鈕時,底部的導(dǎo)航欄欄并不會消失,這是因為子路由僅在自己的范圍內(nèi)有效。要想跳轉(zhuǎn)到其他子路由管理的頁面,就需要在根導(dǎo)航器中進(jìn)行注冊,也就是MaterialApp內(nèi)部的導(dǎo)航器。
路由傳參
在移動應(yīng)用開發(fā)中,頁面參數(shù)的傳遞也是一個比較常見的需求。為了滿足不同場景下頁面跳轉(zhuǎn)過程中參數(shù)傳遞的需求,F(xiàn)lutter提供了路由參數(shù)機(jī)制,可以在打開路由時傳遞參數(shù),然后在目標(biāo)頁面通過RouteSettings來獲取頁面?zhèn)鬟f的參數(shù),如下所示。
Navigator.of(context).pushNamed("second ", arguments: " from first page"); class SecondPage extends StatelessWidget { @override Widget build(BuildContext context) { //取出路由參數(shù) String msg = ModalRoute.of(context).settings.arguments as String; … //數(shù)據(jù)處理 } }
除此之外,對于某些特定的頁面,還需要在其關(guān)閉時回傳頁面處理的處理結(jié)果。這與Android提供的startActivityForResult()方法監(jiān)聽目標(biāo)頁面返回處理結(jié)果的場景類似,F(xiàn)lutter也提供了頁面返回的參數(shù)機(jī)制。具體來說,就是在使用push()方法打開目標(biāo)頁面時,可以設(shè)置目標(biāo)頁面關(guān)閉時監(jiān)聽函數(shù)來獲取返回參數(shù),當(dāng)目標(biāo)頁面關(guān)閉路由時使用pop()方法回傳參數(shù)即可。例如,下面是兩個頁面之間參數(shù)值傳遞和參數(shù)值回傳,代碼如下。
class FirstPage extends StatefulWidget { @override State<StatefulWidget> createState() { return FirstPageState(); } } class FirstPageState extends State<FirstPage> { String result = ''; @override Widget build(BuildContext context) { return Scaffold( body: Center( child: Column( children: <Widget>[ Text('from seconde page: ' + result, style: TextStyle(fontSize: 20)), RaisedButton( child: Text('跳轉(zhuǎn)'), //使用then()獲取目標(biāo)頁面返回參數(shù) onPressed: () => Navigator.of(context) .pushNamed("second", arguments: "from first page") .then((msg) => setState(() => result = msg))) ], )), ); } } class SecondPage extends StatelessWidget { @override Widget build(BuildContext context) { String msg = ModalRoute.of(context).settings.arguments as String; return Scaffold( body: Center( child: Column(children: [ Text('from first screen: ' + msg, style: TextStyle(fontSize: 20)), RaisedButton( child: Text('返回'), onPressed: () => Navigator.pop(context, "from second page")) ]), )); } }
運(yùn)行上面的代碼,可以看到,當(dāng)SecondPage頁面被關(guān)閉重新回到FirstPage頁面時,F(xiàn)irstPage會把回傳的參數(shù)值展示出來,最終效果如下圖所示。
MaterialPageRoute
在使用路由過程中,經(jīng)過會使用到MaterialPageRoute類。MaterialPageRoute繼承自PageRoute類,PageRoute類是一個抽象類,表示占有整個屏幕空間的一個模態(tài)路由頁面,它還定義了路由構(gòu)建及切換時過渡動畫的相關(guān)接口及屬性。
MaterialPageRoute 是Material組件庫提供的組件,它可以針對不同平臺,實現(xiàn)與平臺頁面切換動畫風(fēng)格一致的路由切換動畫:當(dāng)打開頁面時,新的頁面會從屏幕右側(cè)邊緣一致滑動到屏幕左邊,直到新頁面全部顯示到屏幕上,而上一個頁面則會從當(dāng)前屏幕滑動到屏幕左側(cè)而消失;當(dāng)關(guān)閉頁面時,正好相反,當(dāng)前頁面會從屏幕右側(cè)滑出,同時上一個頁面會從屏幕左側(cè)滑入。
MaterialPageRoute 構(gòu)造函數(shù)和各個參數(shù)的意義如下:
MaterialPageRoute({ @required this.builder, RouteSettings settings, this.maintainState = true, bool fullscreenDialog = false, })
它們的具體含義如下:
- builder :是一個WidgetBuilder類型的回調(diào)函數(shù),它的作用是構(gòu)建路由頁面的具體內(nèi)容,返回值是一個widget。我們通常要實現(xiàn)此回調(diào),返回新路由的實例。
- settings: 包含路由的配置信息,如路由名稱、是否初始路由(首頁)。
- maintainState:默認(rèn)情況下,當(dāng)入棧一個新路由時,原來的路由仍然會被保存在內(nèi)存中,如果想在路由沒用的時候釋放其所占用的所有資源,可以設(shè)置maintainState為false。
- fullscreenDialog:表示新的路由頁面是否是一個全屏的模態(tài)對話框,在iOS中,如果fullscreenDialog為true,新頁面將會從屏幕底部滑入(而不是水平方向)。
總結(jié)
Flutter 提供了基本路由和命名路由兩種方式,來管理頁面間的跳轉(zhuǎn)。其中,基本路由需要自己手動創(chuàng)建頁面實例,通過 Navigator.push 完成頁面跳轉(zhuǎn);而命名路由需要提前注冊頁面標(biāo)識符和頁面創(chuàng)建方法,通過 Navigator.pushNamed 傳入標(biāo)識符實現(xiàn)頁面跳轉(zhuǎn)。
對于命名路由,如果我們需要響應(yīng)錯誤路由標(biāo)識符,還需要一并注冊 UnknownRoute。為了精細(xì)化控制路由切換,F(xiàn)lutter 提供了頁面打開與頁面關(guān)閉的參數(shù)機(jī)制,我們可以在頁面創(chuàng)建和目標(biāo)頁面關(guān)閉時,取出相應(yīng)的參數(shù)。可以看到,關(guān)于路由導(dǎo)航,F(xiàn)lutter 綜合了 Android、iOS 和 React 的特點(diǎn),簡潔而不失強(qiáng)大。
在中大型應(yīng)用中,通常還會使用命名路由來管理頁面間的切換。命名路由的最重要作用,就是建立了字符串標(biāo)識符與各個頁面之間的映射關(guān)系,使得各個頁面之間完全解耦,應(yīng)用內(nèi)頁面的切換只需要通過一個字符串標(biāo)識符就可以搞定,為后期模塊化打好基礎(chǔ)。
除此之外,嵌套路由和路由傳參也是路由框架中比較核心的內(nèi)容。本篇只是Flutter路由與導(dǎo)航的基本知識,后面將會從pushReplacementNamed 、 popAndPushNamed、pushNamedAndRemoveUntil和popUntil,以及第三方導(dǎo)航庫和源碼分析等方面來深入介紹Flutter的路由開發(fā)與導(dǎo)航。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
Flutter實現(xiàn)漸變弧形進(jìn)度條的示例詳解
在Flutter開發(fā)中,構(gòu)建一個具有視覺吸引力的、反映進(jìn)度的圓形弧形進(jìn)度條是一個常見需求,本文將詳細(xì)介紹如何使用Flutter和Dart語言實現(xiàn)這一功能,需要的可以參考下2023-12-12