緊接上一篇的有側(cè)邊欄APP,這次我們向APP中加入上下Tab頁(yè),使之跟趨近主流大部分APP的信息布局套路,等不及看源碼的同學(xué)可以點(diǎn)擊進(jìn)入我的git倉(cāng)庫(kù)下載代碼。
Tab關(guān)鍵元素
-
TabController
這是Tab
頁(yè)的控制器,用于定義Tab
標(biāo)簽和內(nèi)容頁(yè)的坐標(biāo),還可配置標(biāo)簽頁(yè)的切換動(dòng)畫效果等。
TabController一般放入有狀態(tài)控件中使用,以適應(yīng)標(biāo)簽頁(yè)數(shù)量和內(nèi)容有動(dòng)態(tài)變化的場(chǎng)景,如果標(biāo)簽頁(yè)在APP中是靜態(tài)固定的格局,則可以在無(wú)狀態(tài)控件中加入簡(jiǎn)易版的DefaultTabController以提高運(yùn)行效率,畢竟無(wú)狀態(tài)控件要比有狀態(tài)控件更省資源,運(yùn)行效率更快。
TabBar
Tab
頁(yè)的Title
控件,切換Tab
頁(yè)的入口,一般放到AppBar
控件下使用,內(nèi)部有*Title屬性。其子元素按水平橫向排列布局,如果需要縱向排列,請(qǐng)使用Column
或ListView
控件包裝一下。子元素為Tab
類型的數(shù)組。TabBarView
Tab
頁(yè)的內(nèi)容容器,其內(nèi)放置Tab
頁(yè)的主體內(nèi)容。子元素可以是多個(gè)各種類型的控件。
Tab使用方法
有狀態(tài)控件搭配TabController
Tab
頁(yè)的切換搭配了動(dòng)畫,因此到State
類上附加一個(gè)SingleTickerProviderStateMixin
:
//定義有狀態(tài)控件
class HomePage extends StatefulWidget {
@override
_HomePageState createState() => new _HomePageState();
}
//用于使用到了一點(diǎn)點(diǎn)的動(dòng)畫效果,因此加入了SingleTickerProviderStateMixin
class _HomePageState extends State<HomePage> with SingleTickerProviderStateMixin{
...
}
然后到有狀態(tài)控件的子類State
中初始化控制器TabController
:
@override
void initState() {
super.initState();
_tabController = new TabController(
vsync: this, //動(dòng)畫效果的異步處理,默認(rèn)格式,背下來(lái)即可
length: 3 //需要控制的Tab頁(yè)數(shù)量
);
}
//當(dāng)整個(gè)頁(yè)面dispose時(shí),記得把控制器也dispose掉,釋放內(nèi)存
@override
void dispose() {
_tabController .dispose();
super.dispose();
}
然后到TabBar
和TabBarView
中的controller屬性中調(diào)用控制器_tabController
//標(biāo)簽頁(yè)標(biāo)題
new TabBar(
tabs: [ //注意TabBar的子元素為Tab類型的數(shù)組
new Tab(icon: new Icon(Icons.directions_car)),
new Tab(icon: new Icon(Icons.directions_transit)),
new Tab(icon: new Icon(Icons.directions_bike)),
]
//標(biāo)簽頁(yè)內(nèi)容區(qū)域
new TabBarView(
children: [
new Icon(Icons.directions_car),
new Icon(Icons.directions_transit),
new Icon(Icons.directions_bike),
]
最后,我們把定義好的TabBar
和TabBarView
安放到需要的地方去,比如:
new Scaffold(
appBar: new AppBar(
backgroundColor: Colors.deepOrange,
title: new Text('title'),
),
....
body: new TabBarView( //TabBarView呈現(xiàn)內(nèi)容,因此放到Scaffold的body中
controller: _bottomNavigation, //配置控制器
children: [ //注意順序與TabBar保持一直
new News(data: '參數(shù)值'), //上一篇定義好的子頁(yè)面
new TabPage2(),
new TabPage3(),
]
),
bottomNavigationBar: new Material( //為了適配主題風(fēng)格,包一層Material實(shí)現(xiàn)風(fēng)格套用
color: Colors.deepOrange, //底部導(dǎo)航欄主題顏色
child: new TabBar( //TabBar導(dǎo)航標(biāo)簽,底部導(dǎo)航放到Scaffold的bottomNavigationBar中
controller: _bottomNavigation, //配置控制器
tabs: _bottomTabs,
indicatorColor: Colors.white, //tab標(biāo)簽的下劃線顏色
),
)
);
無(wú)狀態(tài)控件搭配DefaultTabController
DefaultTabController
要簡(jiǎn)單很多,由于應(yīng)用在無(wú)狀態(tài)控件中,使用DefaultTabController
包裹需要用到Tab
的頁(yè)面即可:
class TabPage3 extends StatelessWidget {
@override
Widget build(BuildContext context) {
return new DefaultTabController(
length: 3,
child: new Scaffold(
appBar: new AppBar(
backgroundColor: Colors.orangeAccent,
title: new TabBar(
tabs: [
new Tab(icon: new Icon(Icons.directions_car)),
new Tab(icon: new Icon(Icons.directions_transit)),
new Tab(icon: new Icon(Icons.directions_bike)),
],
indicatorColor: Colors.white,
),
),
body: new TabBarView(
children: [
new Icon(Icons.directions_car),
new Icon(Icons.directions_transit),
new Icon(Icons.directions_bike),
],
),
),
);
}
}
DefaultTabController
和TabController
的用法差異主要在控制器的定義上,TabBar
和TabBarView
的使用方法完全相同,通常上下Tab
頁(yè)的標(biāo)簽分別安放在Scaffold
控件的appBar和bottomNavigationBar屬性上,然后我們把APP填充成下面這個(gè)樣式:
代碼結(jié)構(gòu)
如上圖所示,APP以底部Tab
導(dǎo)航欄為主入口,底部每個(gè)Tab
中又各自有自己的頂部次級(jí)Tab
頁(yè),因此我們把代碼結(jié)構(gòu)整理一下:
-
_HomePageState
是APP的主頁(yè)面HomePage
的子類State
- 通過(guò)
Scaffold
底部的bottomNavigationBar屬性擺放TabBar
,搭建Tab
頁(yè)的標(biāo)簽欄 - 放入
Scaffold
的body屬性放入TabBarView
,TabBarView
的children是三個(gè)外部dart文件定義的控件頁(yè)面 - 外部dart文件定義的控件頁(yè)面分別又有各自風(fēng)格的
Tab
標(biāo)簽頁(yè) -
Tab
頁(yè)的通用屬性可以提前定義到數(shù)組List
中,在TabBar
和TabBarView
通過(guò)遍歷提取List
的值創(chuàng)建子元素可以提高代碼的維護(hù)效率:
//在`StatefulWidget`控件中,可通過(guò)修改下面的數(shù)組,實(shí)現(xiàn)Tab頁(yè)的動(dòng)態(tài)加載
final List<Tab> myTabs = <Tab>[
new Tab(text: 'Tab1'),
new Tab(text: 'Tab2'),
new Tab(text: 'Tab3'),
new Tab(text: 'Tab4'),
new Tab(text: 'Tab5'),
new Tab(text: 'Tab6'),
new Tab(text: 'Tab7'),
new Tab(text: 'Tab8'),
new Tab(text: 'Tab9'),
new Tab(text: 'Tab10'),
new Tab(text: 'Tab11'),
];
Widget build(BuildContext context) {
return new Scaffold(
appBar: new AppBar(
backgroundColor: Colors.orangeAccent,
title: new TabBar(
controller: _tabController,
tabs: myTabs, //使用Tab類型的數(shù)組呈現(xiàn)Tab標(biāo)簽
indicatorColor: Colors.white,
isScrollable: true,
),
),
body: new TabBarView(
controller: _tabController,
children: myTabs.map((Tab tab) { //遍歷List<Tab>類型的對(duì)象myTabs并提取其屬性值作為子控件的內(nèi)容
return new Center(child: new Text(tab.text+' '+widget.data)); //使用參數(shù)值
}).toList(),
),
);
}
使用獲取到的參數(shù)
由于StatelessWidget
和StatefulWidget
的頁(yè)面構(gòu)建不同,使用從外部獲取到的參數(shù)的方式也略有差異,在這里簡(jiǎn)單總結(jié)下。
-
StatelessWidget
的獲參和用參方式
定義StatelessWidget
控件時(shí),添加一個(gè)final
類型的變量如pageText
,用于為參數(shù)值預(yù)留空間,并在構(gòu)造函數(shù)中加入?yún)?shù)值:
class SidebarPage extends StatelessWidget {
final String pageText; //定義一個(gè)常量,用于保存跳轉(zhuǎn)進(jìn)來(lái)獲取到的參數(shù)
SidebarPage(this.pageText); //構(gòu)造函數(shù),獲取參數(shù)
...
}
使用參數(shù)時(shí)直接引用即可:
Widget build(BuildContext context) {
return new Scaffold(
appBar: new AppBar(title: new Text(pageText),), //將參數(shù)當(dāng)作頁(yè)面標(biāo)題
body: new Center(
child: new Text('pageText'),
),
);
}
從外部傳入?yún)?shù)時(shí),直接向構(gòu)造函數(shù)中填入?yún)?shù)值即可:
Navigator.of(context).push(new MaterialPageRoute(builder:
(BuildContext context) => new SidebarPage('First Page'))); //在new方法時(shí)調(diào)用控件的構(gòu)造函數(shù)傳入?yún)?shù)值
-
StatefulWidget
的獲參和用參方式
相比StatelessWidget
略復(fù)雜。定義構(gòu)造函數(shù)時(shí)需要默認(rèn)聲明key:
class TabPage1 extends StatefulWidget {
const TabPage1({ Key key , this.data}) : super(key: key); //構(gòu)造函數(shù)中增加參數(shù)
final String data; //為參數(shù)分配空間
@override
_MyTabbedPageState createState() => new _MyTabbedPageState();
}
使用時(shí),由于在State
子類中實(shí)現(xiàn)具體的頁(yè)面內(nèi)容,因此State
子類使用父類TabPage1
的參數(shù)時(shí)需要在參數(shù)名前增加一個(gè)widget關(guān)鍵字:
class _MyTabbedPageState extends State<TabPage1> {
...
new Center(child: new Text(tab.text+' '+widget.data)); //使用參數(shù)值,需在參數(shù)名前增加widget前綴
...
}
從外部傳入?yún)?shù)時(shí),需要聲明參數(shù)名:
new TabBarView
controller: _bottomNavigation,
children: [
new TabPage1(data: '參數(shù)值'), //new方法調(diào)用構(gòu)造函數(shù)時(shí),還需要聲明參數(shù)名稱
new TabPage2(),
new TabPage3(),
]
)
好勒,今天就講到這里,大家去下載我的git源碼試試效果吧,代碼中有附加的注釋,對(duì)一些控件屬性的特性也有單獨(dú)的描述,相信看完源碼之后,大家也可以自行實(shí)現(xiàn)效果了。
順便分享一個(gè)雷區(qū),由于當(dāng)初創(chuàng)建這個(gè)項(xiàng)目時(shí),我使用命令flutter create [APPname1]的方式創(chuàng)建了這個(gè)項(xiàng)目,但我發(fā)現(xiàn)這個(gè)APPname1(代稱,并非真實(shí)名稱)不好聽(tīng),想把項(xiàng)目改名為APPname2,于是參考之前寫的安卓怎么打包?,把項(xiàng)目文件夾改名為APPname2,并非常任性的把項(xiàng)目目錄下的android\app\src\main\AndroidManifest.xml文件,把package和android:label都改成了APPname2,于是不出意料的悲催了,命令flutter fun報(bào)錯(cuò),無(wú)法啟動(dòng)APP,還原配置之后,無(wú)法啟動(dòng)APP,即便嘗試通過(guò)全文搜索APPname1,都按規(guī)定格式替換成APPname2,或者逆向改回去,都無(wú)法啟動(dòng)APP,此時(shí)已是凌晨1點(diǎn)。。。妥妥的血淚史,所以鄭重的告誡大家:
不要在項(xiàng)目的各種配置文件中輕易改動(dòng)項(xiàng)目名稱!不要在項(xiàng)目的各種配置文件中輕易改動(dòng)項(xiàng)目名稱!不要在項(xiàng)目的各種配置文件中輕易改動(dòng)項(xiàng)目名稱! 否則你就是下一個(gè)在電腦面前捶胸頓足的魚丸。什么?問(wèn)我怎么恢復(fù)的?當(dāng)然是托g(shù)it的福。
感謝大家的支持,請(qǐng)關(guān)注我的Flutter圈子,多多投稿,也可以加入flutter 中文社區(qū)(官方QQ群:338252156)共同成長(zhǎng),謝謝大家~