前言
AngularJS路由主要有内置的ngRoute和一个基于ngRoute开发的第三方路由模块ui-router,内置的ngRoute有时满足开发需求,使用ui-router可以解决很多原生ngRoute的不足。
AngularJS的路由实际上是一种纯前端的解决方案,它的本质是:当请求一个url时,根据路由配置这个url,然后再请求模板片段,并插入到ng-view中。AngularJS的路由更倾向于通过改变url进行页面的局部刷新。
一 ngRoute
使用ngRoute需要额外加载这个模块文件,如:
同时还需要在模块声明中注入对ngRoute的依赖:
var app = angular.module('MyApp', ['ngRoute']);
使用ngRoute包含以下几个内容:
名称 | 所属 | 使用 |
---|---|---|
ngView | directive | 提供不同路由模板插入的视图层 |
$routeProvider | provider | 提供路由配置 |
$route | service | 用于构建各个路由的url,view,controller的关系 |
$routeParams | service | 解析返回路由中带有的参数 |
$routeProvider提供了定义路由表的服务,有两个核心方法:
1. when(path,route)
path: string类型,表示该条路由规则所匹配的路径。
注意: 如果路径中需要匹配参数,如path路径是:/show/:name,如果地址栏为:/show/lydia,那么这里的name以及所对应的值lydia都会保存在$routeParams服务中,需要通过$routeParams.name来获取。
route: object类型,用来指定一系列配置项。
配置 | 说明 |
---|---|
controller | 控制器名称 |
controllerAs | 给控制器起个别名 |
template | 对应路径的页面模板,会出现在ng-view处 |
templateUrl | 对应模板的路径 |
resolve | 该属性会以键值对对象的形式,给路由相关的控制器绑定服务或者值。然后把执行的结果值或者对应的服务引用,注入到控制器中。如果resolve中是一个promise对象,那么会等它执行成功后,才注入到控制器中,此时控制器会等待resolve中的执行结果。 |
redirectTo | 重定向地址 |
reloadOnSearch | 设置是否在只有地址改变时,才加载对应的模板。search和params改变都不会加载模板。默认为true,当$location.search()发生变化时会重新加载路由。 |
caseInsensitiveMatch | 路径区分大小写 |
2.otherwise(params)
对应了路径匹配不到时的情况。
使用方法
第一步:添加页面
html页面,哪里需要局部刷新,哪里就用ng-view:
<body ng-app="routeApp"> <div ng-view>div> <script src="bower_components/angular/angular.js">script> <script src="scripts/app.js">script> <script src="scripts/controllers/main.js">script> body>
第二步:controller添加路由配置
var routeApp = angular.module('routeApp',[]); routeApp.config(['$routeProvider',function ($routeProvider) { $routeProvider .when('/list', { templateUrl: 'views/route/list.html', controller: 'RouteListCtl' }) .when('/list/:id', { templateUrl: 'views/route/detail.html', controller: 'RouteDetailCtl' }) .otherwise({ redirectTo: '/list' }); }]);
再添加两个controller
routeApp.controller('RouteListCtl',function($scope) { }); routeApp.controller('RouteDetailCtl',function($scope, $routeParams) { $scope.id = $routeParams.id; });
上面这个例子只是简单的例举一下带参数和不带参数的url的路由配置和获取方法,具体的html页面和结果就不展示了。
resolve的用法
$routeProvider的第二个参数是路由的一些具体配置项目,这里有一个比较重要的配置,即resolve。配置resolve意味着在进入这个路由之前必须等待resolve中的数据返回,也就是说,在跳转目标路由之前先做一些额外工作去预加载数据,只有当数据准备妥当之后,才会去载入目标路由的模板和执行相应的controller。
$routeProvider .when("/news", { templateUrl: "newsView.html", controller: "newsController", resolve: { message: function(messageService){ return messageService.getMessage(); } } })
在上例中,只有message有值的情况下才会去加载html页面和js。
在路由跳转之前,会触发resolve下的所有promise,只有当所有的promise都被正确的resolve之后才会进行路由切换,此时$route会抛出$routeChangeSuccess的事件,如果没有被正确的resolve,那么$route会抛出$routeChangeError的事件,并且终止路由切换。
二 ui-router
ui-router相比ngRoute的优势在于,一个页面可以嵌套多个视图,,创建嵌套分层的视图,多个视图去控制某一个视图等。
安装:
npm install angular-ui-router --save
同时在项目中引入:
对应的controller中引入ui-router的依赖:
angular.module('myApp', ['ui.router']);
ui-router包含的内容与ngRoute很像,可以进行一下类比:
ngRoute | ui-router |
---|---|
ng-view | ui-view |
$routeProvider | $stateProvider |
$routeParams | $stateParams |
$route | $state |
1.$state配置参数
参数 | 说明 |
---|---|
url | 默认相对路径(以^开头的是绝对路径) |
views | views里的每个子视图可以包含自己的模板、控制器和预载入数据 |
abstract | 抽象模板不能被激活 |
template | HTML字符串或者返回HTML字符串的函数 |
举个例子:
html页面:
<body> <div> <div ui-view="filters">div> <div ui-view="mailbox">div> <div ui-view="priority">div> div> body>
js:
angular.module('myApp').config(['$stateProvider',function($stateProvider) { $stateProvider .state('report',{ views: { 'filters': { template: 'Filter inbox
', controller: function($scope) {} }, 'mailbox': { templateUrl: 'partials/mailbox.html' }, 'priority': { template: 'Priority inbox
', resolve: { facebook: function() { return FB.messages(); } } } } }).state('blog',{ url:'/blog', views:{ 'container':{templateUrl:'templates/blog/layout.html'} } })
abstract抽象模板
抽象模板不能被激活,但是它的子模板可以被激活。抽象模板通常用于提供一个包括了很多视图的模板,它可以传递$scope作用域给子模板,也可以在同一个url下传递自定义数据或预加载的依赖。如:
$stateProvider .state('admin', { abstract: true, url: '/admin', template: '' }) .state('admin.index', { url: '/index', template: 'Admin index
' }) .state('admin.users', { url: '/users', template: '
- ...
2.$stateParams
使用$stateparams来提取在url中的不同参数。
如果一个url是这样的:
'/inbox/:inboxId/messages/{sorted}?from&to'
当用户访问时,请求的url是这样的:
'/inbox/123/messages/ascending?from=10&to=20'
那么$stateParams对象的值为:
{inboxId: '123', sorted: 'ascending', from: 10, to: 20}
3.$urlRouterProvider
$urlRouterProvider和ngRoute一样,有when()和otherwise()两种用法,除此之外,还有rule()方法,可以越过任何url的匹配或者在其他路由前做路由修改,函数返回一个有效的路径的字符串。
app.config(function($urlRouterProvider){ // 忽略url的大小写 $urlRouterProvider.rule(function ($injector, $location) { var path = $location.path(), normalized = path.toLowerCase(); if (path != normalized) return normalized; }); })
路由的匹配方式
url:"/user/:id"
url:"/user/{id}"
上面的这两个写法是一样的。
// 只会匹配 contactId 为1到8位的数字 url: "/contacts/{contactId:[0-9]{1,8}}"
可以通过?来指定参数作为查询参数,如:
url: "/contacts?myParam" //匹配 "/contacts?myParam=value" url: "/contacts?myParam1&myParam2" // 匹配 "/contacts?myParam1=value1&myParam2=wowcool"