在这一步中,你将学会如何通过使用被称为'ngRoute'的Angular模块添加路由,创建一个布局模板,以及如何绑定一个具有多视图的应用。
app/index.html
上时,你将跳车到app/index.html/#/phones
,而且手机列表出现在浏览器中。把工作空间重置到第七步
git checkout -f step-7
刷新你的浏览器或在线检查这一步:Step 7 Live Demo
下面列出了第六步和第七步之间的区别。你可以在GitHub里看到完整的差异。
这一步中添加路由功能是由 ngRoute
模块中的angular提供的,它与核心的Angular框架分离分布。
我们使用Bower以安装客户端依赖性。这一步更新了bower.json
配置文件,以包含新的依赖性:
{
"name": "angular-phonecat",
"description": "A starter project for AngularJS",
"version": "0.0.0",
"homepage": "https://github.com/angular/angular-phonecat",
"license": "MIT",
"private": true,
"dependencies": {
"angular": "1.4.x",
"angular-mocks": "1.4.x",
"jquery": "~2.1.1",
"bootstrap": "~3.1.1",
"angular-route": "1.4.x"
}
}
新的依赖性"angular-route": "1.4.x"
告诉bower要安装与v1.4x兼容的angular-router组件版本。我们将告诉bower以下载并安装该依赖性。
如果你已经全局安装了bower,则你可以只对该项目运行bower install
,我们已经预配置了npm,从而为我们运行bower安装:
npm install
我们的应用渐渐地完善,变得越来越复杂。在第七步之前,应用向我们用户提供了单一视图(手机的列表),而且所有的模板代码都位于index.html
文件中。构建应用的下一步是添加一个视图,这个视图将显示我们的列表中每款设备的详细信息。
要想添加详情视图,我们可以扩展index.html
以包含两套视图的模板代码,但是那将很快变得混乱。因此我们不用这种方法,而是把index.html
变成“布局模板”。这是一个模板,常用于我们应用中的所有视图。然后别的“局部布局模板”根据当前的“路由”包含到这个布局模板中,从而形成一个完整视图展示给用户。
通过$routeProvider来声明Angular中的应用程序路由,它是$route服务的提供者。这个服务使接通控制器、视图模板以及浏览器中的当前位置变得容易。利用这个功能,我们可以实现深链接,深链接让我们可以使用浏览器的历史(回退和前进导航)以及书签。
如你已注意到的,依赖性注入(DI)是AngularJS的核心,所以对它的工作原理略知一二是很重要的。
在应用程序引导中,Angular创建了一个注入器,注入器用来寻找并注入你的应用所需要的所有的服务。注入器本身对$http
或$route
服务是做什么的一无所知。实际上,注入器甚至不知道这些服务是否存在,除非用适当的模板定义对它进行配置。
注入器只在以下步骤中出场:
提供者是提供(创建)服务实例并且对外提供配置API的对象,API可以用来控制一个服务的创建和运行时行为。对于$route
来说,$routeProvider
对外提供API,API允许你定义针对你的应用程序的路由。
Angular模块解决了从应用程序中移除全局状态的问题,并提供配置注入器的方法。相对于AMD或require.js模块,Angular模块并不试图解决脚本载入次序问题或者懒惰式脚本取得问题。这些目标是完全独立的,两个模块系统可以并立存在,并实现他们的目标。
要想加深你对Angular上的DI的理解,请参看理解依赖性注入。
$route
服务常与ngView指令结合使用。ngView
指令的角色是在布局模板中包含用于当前路由的视图模板。这使它完美恰合我们的index.html
模板。
app/index.html
:
<!doctype html>
<html lang="en" ng-app="phonecatApp">
<head>
...
<script src="/attachments/image/wk/angularjs/angular.js"></script>
<script src="/attachments/image/wk/angularjs/angular-route.js"></script>
<script src="/attachments/image/wk/angularjs/app.js"></script>
<script src="/attachments/image/wk/angularjs/controllers.js"></script>
</head>
<body>
<div ng-view></div>
</body>
</html>
我们已经在我们的索引文件添加了两个新的<script>
标记,从而把外部JavaScript文件载入到我们的应用程序中:
angular-route.js
: 定义Angular ngRoute
模块,ngRoute
模块向我们提供了路由。app.js
: 现在这个文件控住了我们的应用程序的根模块。注意:我们删除了index.html
模板中的大部分代码,把它替换成一行代码,包含了一个带有元素属性ng-view
的div。我们已经移除的这个代码被放到了phone-list.html
模板中:
app/partials/phone-list.html
:
<div class="container-fluid">
<div class="row">
<div class="col-md-2">
<!--Sidebar content-->
Search: <input ng-model="query">
Sort by:
<select ng-model="orderProp">
<option value="name">Alphabetical</option>
<option value="age">Newest</option>
</select>
</div>
<div class="col-md-10">
<!--Body content-->
<ul class="phones">
<li ng-repeat="phone in phones | filter:query | orderBy:orderProp" class="thumbnail">
<a href="#/phones/{{phone.id}}" class="thumb"><img ng-src="{{phone.imageUrl}}"></a>
<a href="#/phones/{{phone.id}}">{{phone.name}}</a>
<p>{{phone.snippet}}</p>
</li>
</ul>
</div>
</div>
</div>
我们还为手机详情视图添加了一个占位符模板:
app/partials/phone-detail.html
:
TBD: detail view for <span>{{phoneId}}</span>
注意,我们正在使用的phoneId
表达式将在PhoneDetailCtrl
控制器中定义。
要想增强应用的组织,我们动用了Angular的ngRoute
模块,我们已经把控制器移到它们自己的模块phonecatControllers
中(如下所示)。
我们给index.html
添加angular-route.js
,并在controllers.js
中创建一个新的phonecatControllers
模块。然而,要想使用它们的代码,我们需要做的不止于此。我们还需要添加模块,作为我们的应用的依赖性。通过把两个应用作为phonecatApp
的依赖性列表,我们可以使用这些指令以及它们提供的服务。
app/js/app.js
:
var phonecatApp = angular.module('phonecatApp', [
'ngRoute',
'phonecatControllers'
]);
...
注意第二个参数传递到angular.module
,['ngRoute','phonecatControllers']
。这个数组列出了phonecatApp
所依赖的模块。
...
phonecatApp.config(['$routeProvider',
function($routeProvider) {
$routeProvider.
when('/phones', {
templateUrl: 'partials/phone-list.html',
controller: 'PhoneListCtrl'
}).
when('/phones/:phoneId', {
templateUrl: 'partials/phone-detail.html',
controller: 'PhoneDetailCtrl'
}).
otherwise({
redirectTo: '/phones'
});
}]);
使用phonecatApp.config()
方法,我们请求了$routeProvider
,它会被注入到我们的配置函数中,并使用?$routeProvider.when()
方法以定义我们的路由。
我们的应用程序路由定义如下:
when('/phones')
:当URL映射段为/phones
的时候。将展示这个手机列表视图。要想构造这个视图,Angular将使用phone-list.html
模板,以及PhoneListCtrl
控制器。when('/phones/:phoneId')
:当URL映射段匹配/phones/:phoneId
的时候(其中:phoneId
是URL的变量部分),将展示手机详情视图。要想构造手机详情视图,Angular将使用phone-detail.html
模板以及PhoneDetailCtrl
控制器。otherwise({redirectTo: '/phones'})
:当浏览器的地址不匹配我们别的路由的时候,触发一个重定向到/phones
。我们再次使用我们在上一步中构造的PhoneListCtrl
控制器,并为手机详情视图向app/js/controllers.js
文件添加了一个新的、空的PhoneDetailCtrl
控制器。
注意在第二个路由声明中:phoneId
参数的使用。$route
服务使用route声明'/phones/:phoneId'
作为匹配当前URL的模板。所有用:
记号法定义的变量都会提取出来,放到?$routeParams
对象上。
app/js/controllers.js
:
var phonecatControllers = angular.module('phonecatControllers', []);
phonecatControllers.controller('PhoneListCtrl', ['$scope', '$http',
function ($scope, $http) {
$http.get('phones/phones.json').success(function(data) {
$scope.phones = data;
});
$scope.orderProp = 'age';
}]);
phonecatControllers.controller('PhoneDetailCtrl', ['$scope', '$routeParams',
function($scope, $routeParams) {
$scope.phoneId = $routeParams.phoneId;
}]);
再次提醒注意,我们创建了一个新的模块,称为phonecatControllers
。对于小型的AngularJS应用,通常针对所有的控制器只创建一个模板,如果控制器只有为数不多的几个。随着你的应用程序扩大,常常要把你的代码重构到额外的模块中。为了更大的应用,你可能将会想要为你的应用的所有的主要功能创建独立的模块。
因为我们的应用比较小,我们将把我们所有的控制器添加到phonecatControllers
模块中。
要想自动核查所有东西都正确连通了,我们编写了一个端到端的测试,导航到不同的URL上,并核查是否呈现了正确的视图。
...
it('should redirect index.html to index.html#/phones', function() {
browser.get('app/index.html');
browser.getLocationAbsUrl().then(function(url) {
expect(url).toEqual('/phones');
});
});
describe('Phone list view', function() {
beforeEach(function() {
browser.get('app/index.html#/phones');
});
...
describe('Phone detail view', function() {
beforeEach(function() {
browser.get('app/index.html#/phones/nexus-s');
});
it('should display placeholder page with phoneId', function() {
expect(element(by.binding('phoneId')).getText()).toBe('nexus-s');
});
});
你现在可以再次运行npm run protractor
来查看测试的运行。
index.html
的{{orderProp}}
,而且你将看到什么事也没有发生,哪怕你正在手机列表视图中。这是因为orderProp
模块只有在PhoneListCtrl
管理的作用域内是可见的,PhoneListCtrl
与<div ng-view>
元素关联。如果你在phone-list.html
模板上添加同样的绑定,绑定将如你的预期运作起来。随着路由设置成功以及手机列表视力的实现,我们已经准备好前往第八步 更多模板,以实现手机详情视图。