路由(Route)在移动开发中一般指页面(Page),这跟web开发中单页应用的Route概念意义是相同的,Route在Android中一般指一个Activity,在iOS中指一个ViewController。所谓路由管理,就是管理页面之间如何跳转,一般也可被称为导航管理。这和原生开发相似,不管是Android仍是iOS,导航管理都会维护一个路由栈,路由入栈(push)操做对应打开一个新页面,路由出栈(pop)操做对应页面关闭操做,而路由管理主要是指如何来管理路由栈。git
咱们在上一节“计数器”示例的基础上,作以下修改:github
class SecondPageRoute extends StatelessWidget { final Topic = Text("【全栈编程】- onajax.com"); @override Widget build(BuildContext context) { // TODO: implement build return Scaffold( appBar: AppBar( title: Text("【全栈编程】- onajax.com"), ), body: Center( child: Text("这是第二个路由页面"), ), ); } }
新路由继承自StatelessWidget,界面很简单,在页面中间显示一句"这是第二个路由页面"。web
Column( mainAxisAlignment: MainAxisAlignment.center, children: <Widget>[ ... //省略无关代码 FlatButton( child: Text("点我打开一个新页面",style: TextStyle(fontWeight: FontWeight.bold),), textColor: Colors.green, onPressed: () { //导航到一个新的路由页面 Navigator.push(context, new MaterialPageRoute(builder: (context) { return SecondPageRoute(); }) ); }, ), ], )
咱们添加了一个打开新路由的按钮,并将按钮文字颜色设置为蓝色,点击该按钮后就会打开新的路由页面。ajax
import 'package:flutter/material.dart'; void main() => runApp(new MyApp()); class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return new MaterialApp( title: '【全栈编程】- onajax.com', theme: new ThemeData( primarySwatch: Colors.blue, ), home: new MyHomePage(title: '【全栈编程】- onajax.com'), ); } } class MyHomePage extends StatefulWidget { MyHomePage({Key key, this.title}) : super(key: key); final String title; @override _MyHomePageState createState() => new _MyHomePageState(); } class _MyHomePageState extends State<MyHomePage> { int _counter = 0; void _incrementCounter() { setState(() { _counter++; }); } @override Widget build(BuildContext context) { return new Scaffold( appBar: new AppBar( title: new Text(widget.title), ), body: new Center( child: new Column( mainAxisAlignment: MainAxisAlignment.center, children: <Widget>[ new Text( '【全栈编程】- onajax.com提示:你已经点击了--', ), new Text( '$_counter', style: Theme.of(context).textTheme.display1, ), FlatButton( child: Text("点我打开一个新页面",style: TextStyle(fontWeight: FontWeight.bold),), textColor: Colors.green, onPressed: () { //导航到一个新的路由页面 Navigator.push(context, new MaterialPageRoute(builder: (context) { return SecondPageRoute(); }) ); }, ), ], ), ), floatingActionButton: new FloatingActionButton( onPressed: _incrementCounter, tooltip: '【全栈编程】- onajax.com', child: new Icon(Icons.add), ), // This trailing comma makes auto-formatting nicer for build methods. ); } } class SecondPageRoute extends StatelessWidget { final Topic = Text("【全栈编程】- onajax.com"); @override Widget build(BuildContext context) { // TODO: implement build return Scaffold( appBar: AppBar( title: Text("【全栈编程】- onajax.com"), ), body: Center( child: Text("这是第二个路由页面"), ), ); } }
MaterialPageRoute继承自PageRoute类,PageRoute类是一个抽象类,表示占有整个屏幕空间的一个模态路由页面,它还定义了路由构建及切换时过渡动画的相关接口及属性。编程
MaterialPageRoute 是Material组件库的一个Widget,它能够针对不一样平台,实现与平台页面切换动画风格一致的路由切换动画:bash
对于Android,当打开新页面时,新的页面会从屏幕底部滑动到屏幕顶部;当关闭页面时,当前页面会从屏幕顶部滑动到屏幕底部后消失,同时上一个页面会显示到屏幕上。app
对于iOS,当打开页面时,新的页面会从屏幕右侧边缘一致滑动到屏幕左边,直到新页面所有显示到屏幕上,而上一个页面则会从当前屏幕滑动到屏幕左侧而消失;当关闭页面时,正好相反,当前页面会从屏幕右侧滑出,同时上一个页面会从屏幕左侧滑入。less
下面咱们介绍一下MaterialPageRoute 构造函数的各个参数的意义:ide
MaterialPageRoute({ WidgetBuilder builder, RouteSettings settings, bool maintainState = true, bool fullscreenDialog = false, })
builder 是一个WidgetBuilder类型的回调函数,它的做用是构建路由页面的具体内容,返回值是一个widget。咱们一般要实现此回调,返回新路由的实例。函数
settings 包含路由的配置信息,如路由名称、是否初始路由(首页)。
maintainState:默认状况下,当入栈一个新路由时,原来的路由仍然会被保存在内存中,若是想在路由没用的时候释放其所占用的全部资源,能够设置maintainState为false。
fullscreenDialog表示新的路由页面是不是一个全屏的模态对话框,在iOS中,若是fullscreenDialog为true,新页面将会从屏幕底部滑入(而不是水平方向)。
若是想自定义路由切换动画,能够本身继承PageRoute来实现,咱们将在后面介绍动画时,实现一个自定义的路由Widget。
Navigator是一个路由管理的widget,它经过一个栈来管理一个路由widget集合。一般当前屏幕显示的页面就是栈顶的路由。Navigator提供了一系列方法来管理路由栈,在此咱们只介绍其最经常使用的两个方法:
将给定的路由入栈(即打开新的页面),返回值是一个Future对象,用以接收新路由出栈(即关闭)时的返回数据。
将栈顶路由出栈,result为页面关闭时返回给上一个页面的数据。
Navigator 还有不少其它方法,如Navigator.replace、Navigator.popUntil等,详情请参考API文档或SDK源码注释,在此再也不赘述。下面咱们还须要介绍一下路由相关的另外一个概念“命名路由”。
Navigator类中第一个参数为context的静态方法都对应一个Navigator的实例方法, 好比Navigator.push(BuildContext context, Route route)等价于Navigator.of(context).push(Route route) ,下面命名路由相关的方法也是同样的。
所谓命名路由(Named Route)即给路由起一个名字,而后能够经过路由名字直接打开新的路由。这为路由管理带来了一种直观、简单的方式。
要想使用命名路由,咱们必须先提供并注册一个路由表(routing table),这样应用程序才知道哪一个名称与哪一个路由Widget对应。路由表的定义以下:
Map<String, WidgetBuilder> routes;
它是一个Map, key 为路由的名称,是个字符串;value是个builder回调函数,用于生成相应的路由Widget。咱们在经过路由名称入栈新路由时,应用会根据路由名称在路由表中找到对应的WidgetBuilder回调函数,而后调用该回调函数生成路由widget并返回。
咱们须要先注册路由表后,咱们的Flutter应用才能正确处理命名路由的跳转。注册方式很简单,咱们回到以前“计数器”的示例,而后在MyApp类的build方法中找到MaterialApp,添加routes属性,代码以下:
return new MaterialApp( title: '【全栈编程】- onajax.com', theme: new ThemeData( primarySwatch: Colors.blue, ), routes: { "third_page":(context)=>ThirdPageRoute(), }, home: new MyHomePage(title: '【全栈编程】- onajax.com'), ); //同时添加第三个页面的代码 class ThirdPageRoute extends StatelessWidget { final Topic = Text("【全栈编程】- onajax.com"); @override Widget build(BuildContext context) { // TODO: implement build return Scaffold( appBar: AppBar( title: Text("【全栈编程】- onajax.com"), ), body: Center( child: Text("这是第三个路由页面"), ), ); } }
如今咱们就完成了路由表的注册。
要经过路由名称来打开新路由,可使用:
Future pushNamed(BuildContext context, String routeName,{Object arguments})
Navigator 除了pushNamed方法,还有pushReplacementNamed等其余管理命名路由的方法,读者能够自行查看API文档。
接下来咱们经过路由名来打开新的路由页,再添加一个FlatButton的onPressed回调代码,改成:
FlatButton( child: Text("点我打开第三个新页面",style: TextStyle(fontWeight: FontWeight.bold),), textColor: Colors.green, onPressed: () { //导航到一个新的路由页面 Navigator.pushNamed(context, "third_page"); }, )
热重载应用,再次点击“点我打开第三个新页面”按钮,依然能够打开新的路由页。
import 'package:flutter/material.dart'; void main() => runApp(new MyApp()); class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return new MaterialApp( title: '【全栈编程】- onajax.com', theme: new ThemeData( primarySwatch: Colors.blue, ), routes: { "third_page":(context)=>ThirdPageRoute(), }, home: new MyHomePage(title: '【全栈编程】- onajax.com'), ); } } class MyHomePage extends StatefulWidget { MyHomePage({Key key, this.title}) : super(key: key); final String title; @override _MyHomePageState createState() => new _MyHomePageState(); } class _MyHomePageState extends State<MyHomePage> { int _counter = 0; void _incrementCounter() { setState(() { _counter++; }); } @override Widget build(BuildContext context) { return new Scaffold( appBar: new AppBar( title: new Text(widget.title), ), body: new Center( child: new Column( mainAxisAlignment: MainAxisAlignment.center, children: <Widget>[ new Text( '【全栈编程】- onajax.com提示:你已经点击了--', ), new Text( '$_counter', style: Theme.of(context).textTheme.display1, ), FlatButton( child: Text("点我打开第二个新页面",style: TextStyle(fontWeight: FontWeight.bold),), textColor: Colors.green, onPressed: () { //导航到一个新的路由页面 Navigator.push(context, new MaterialPageRoute(builder: (context) { return SecondPageRoute(); }) ); }, ), FlatButton( child: Text("点我打开第三个新页面",style: TextStyle(fontWeight: FontWeight.bold),), textColor: Colors.green, onPressed: () { //导航到一个新的路由页面 Navigator.pushNamed(context, "third_page"); }, ) ], ), ), floatingActionButton: new FloatingActionButton( onPressed: _incrementCounter, tooltip: '【全栈编程】- onajax.com', child: new Icon(Icons.add), ), // This trailing comma makes auto-formatting nicer for build methods. ); } } class SecondPageRoute extends StatelessWidget { final Topic = Text("【全栈编程】- onajax.com"); @override Widget build(BuildContext context) { // TODO: implement build return Scaffold( appBar: AppBar( title: Text("【全栈编程】- onajax.com"), ), body: Center( child: Text("这是第二个路由页面"), ), ); } } class ThirdPageRoute extends StatelessWidget { final Topic = Text("【全栈编程】- onajax.com"); @override Widget build(BuildContext context) { // TODO: implement build return Scaffold( appBar: AppBar( title: Text("【全栈编程】- onajax.com"), ), body: Center( child: Text("这是第三个路由页面"), ), ); } }
在Flutter最初的版本中,命名路由是不能传递参数的,后来才支持了参数;下面展现命名路由如何传递并获取路由参数:
咱们先注册一个路由:
routes:{ "parameters_page":(context)=>ParametersRoute(), } ,
在路由页经过RouteSetting对象获取路由参数:
class ParametersRoute extends StatelessWidget { @override Widget build(BuildContext context) { //获取路由参数 var args = ModalRoute.of(context).settings.arguments //...省略无关代码 } }
在打开路由时传递参数
Navigator.of(context).pushNamed("parameters_page", arguments: "【全栈编程】- onajax.com");
import 'package:flutter/material.dart'; void main() => runApp(new MyApp()); class MyApp extends StatelessWidget { @override Widget build(BuildContext context) { return new MaterialApp( title: '【全栈编程】- onajax.com', theme: new ThemeData( primarySwatch: Colors.blue, ), routes: { "third_page":(context)=>ThirdPageRoute(), "parameters_page":(context)=>ParametersRoute(), }, home: new MyHomePage(title: '【全栈编程】- onajax.com'), ); } } class MyHomePage extends StatefulWidget { MyHomePage({Key key, this.title}) : super(key: key); final String title; @override _MyHomePageState createState() => new _MyHomePageState(); } class _MyHomePageState extends State<MyHomePage> { int _counter = 0; void _incrementCounter() { setState(() { _counter++; }); } @override Widget build(BuildContext context) { return new Scaffold( appBar: new AppBar( title: new Text(widget.title), ), body: new Center( child: new Column( mainAxisAlignment: MainAxisAlignment.center, children: <Widget>[ new Text( '【全栈编程】- onajax.com提示:你已经点击了--', ), new Text( '$_counter', style: Theme.of(context).textTheme.display1, ), FlatButton( child: Text("点我打开第二个新页面",style: TextStyle(fontWeight: FontWeight.bold),), textColor: Colors.green, onPressed: () { //导航到一个新的路由页面 Navigator.push(context, new MaterialPageRoute(builder: (context) { return SecondPageRoute(); }) ); }, ), FlatButton( child: Text("点我打开第三个新页面",style: TextStyle(fontWeight: FontWeight.bold),), textColor: Colors.green, onPressed: () { //导航到一个新的路由页面 Navigator.pushNamed(context, "third_page"); }, ), FlatButton( child: Text("携带参数打开新页面",style: TextStyle(fontWeight: FontWeight.bold),), textColor: Colors.green, onPressed: () { //导航到一个新的路由页面 // Navigator.pushNamed(context, "third_page"); Navigator.of(context).pushNamed("parameters_page",arguments:"【全栈编程】- onajax.com"); }, ) ], ), ), floatingActionButton: new FloatingActionButton( onPressed: _incrementCounter, tooltip: '【全栈编程】- onajax.com', child: new Icon(Icons.add), ), // This trailing comma makes auto-formatting nicer for build methods. ); } } class SecondPageRoute extends StatelessWidget { final Topic = Text("【全栈编程】- onajax.com"); @override Widget build(BuildContext context) { // TODO: implement build return Scaffold( appBar: AppBar( title: Text("【全栈编程】- onajax.com"), ), body: Center( child: Text("这是第二个路由页面"), ), ); } } class ThirdPageRoute extends StatelessWidget { final Topic = Text("【全栈编程】- onajax.com"); @override Widget build(BuildContext context) { // TODO: implement build return Scaffold( appBar: AppBar( title: Text("【全栈编程】- onajax.com"), ), body: Center( child: Text("这是第三个路由页面"), ), ); } } class ParametersRoute extends StatelessWidget { final Topic = Text("【全栈编程】- onajax.com"); @override Widget build(BuildContext context) { // TODO: implement build var args = ModalRoute.of(context).settings.arguments; return Scaffold( appBar: AppBar( title: Text("【全栈编程】- onajax.com"), ), body: Center( child: Text("路由到此页面获取到的数据为:\n" + args), ), ); } }