美文网首页一起学AngularJS
【一起学AngularJS】第九章、多视图和视图路由

【一起学AngularJS】第九章、多视图和视图路由

作者: 40ab6525bf35 | 来源:发表于2016-04-07 18:15 被阅读527次

本章我们将一起学习:

  • 如何创建一个布局模版
  • 如何如何创建一个多视图路由应用
  • 如何使用ngRoute指令实现视图路由

我们先看看本章对应的例子要做的事情是什么:

  • 当你点击导航栏导航到app/index.html时,你将被重定向到app/index.html/#/phones,它会显示手机列表。
  • 当你点击一个手机链接时,URL地址栏的地址变化(显然),新的页面将显示手机的一些信息。

【注解】本章需要一定Provider提供者的知识,可以先看本章教程,如果看完之后想系统学习下提供者、服务相关的知识,点击AngularJS服务体系查看。

下面我们把代码切换到step-7:

git checkout -f step-7

假设你已经运行了网站,你只需要刷新你的浏览器来看效果。或者你可以在线看效果

相关依赖

我们通过ngRoute指令实现视图路由技术,它不属于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.2.1",
    "bootstrap": "~3.1.1",
    "angular-route": "1.4.x"
  }
}

"angular-route": "1.4.x" 这句话告诉bower安装1.4.x版本的Angular路由插件。我们需要保证路由插件的成功安装。
如果你已经全局安装了bower管理器,你可以通过bower install来安装所有的依赖。但是对于本项目来说,我们已经在npm脚本中配置了bower install的执行,所以我们只需要运行:

npm install

注意:如果你运行上述命令后,恰好一个新的Angular版本发布了,这时候,bower install命令可能会执行失败,因为新旧版本的AngularJS有冲突。如果你遇到了这个问题,你只需要删除你的app/bower_components文件夹,再次运行npm install

多视图,路由技术和布局模版

我们的应用内容越来越丰富了。在本章之前,应用只有一个视图(手机列表),并且所有的模版代码都在index.html文件中。下面我们将为列表中的每一个手机添加一个详情视图。
我们可以直接把详情视图添加到inde.html中,但是这样做会让index.html变得特别大,看起来会很糟糕。所以我们换一种做法,我们将把index.html分解成布局模版。这个模版适用于本应用中的所有页面(注解:这和sitemesh、velocity、apache Tiles等服务端模版技术对应)。其他的局部模版将根据当前的路由被选择性的集成到当前模版中,从而最终呈现给用户。
Angular使用$routeProvider来申明应用应用路由,它是$route service的提供者。这个服务可以很容易的把控制器、视图模版和当前的URL地址绑定在一起。通过这个特性,我们可以实现deep linking,通过它我们可以利用浏览器的历史功能(往后和前进)以及书签功能。

探讨下依赖注入、注入器和提供者

依赖注入功能是AngularJS的核心功能,所以了解一点它的知识是有必要的。
当应用启动时,AngularJS将先创建一个注入器,它将寻找并且注入应用所需要的所有服务。注入器本身是不知道$http或者$route服务是干嘛的。实时上,注入器都不知道它们的存在,除非他们被依赖进来。
注入器只完成以下几个步骤:

  • 加载应用中指定的模块定义
  • 注册模块定义中所有的提供器(提供者)——配置阶段
  • 当需要的时候,注入服务或者提供者延迟初始化的依赖等。——运行阶段

提供者的功能为创建服务实例和暴露配置API,后者包括控制服务的创建和运行时行为。在$route服务中,$routeProvider暴露一些允许你定义路由的API。

注意:提供者只能在config函数里被注入。所以你无法把$routeProvider注入到PhoneListCtrl中。

Angular模块解决了移除应用全局状态的问题,并且提供了一个配置注入器的方式。跟AMD或者require.js不一样的是,Angular模块不会去解决脚本加载顺序或者延迟脚本获取的问题。这些目标是相互独立的,他们可以共同工作于一个系统中,各自完成自己的目标(意思就是AngularJS和AMD或者require.js框架可以公用)。
如果你想进一步了解Angular中的依赖注入,可以看看这里:理解依赖注入.

模版

$route指令通常和$ngView指令结合使用。$ngView指令所扮演的角色是把当前路由对应的视图模版加入布局模版中。所以这里使用它正好。

注意:从AngularJS 1.2起,ngRoute就是Angular的自有模块了,而且必须通过加载另外的angular-route.js文件来完成载入(由Bower下载)

app/index.html

<!doctype html>
<html lang="en" ng-app="phonecatApp">
<head>
...
  <script src="bower_components/angular/angular.js"></script>
  <script src="bower_components/angular-route/angular-route.js"></script>
  <script src="js/app.js"></script>
  <script src="js/controllers.js"></script>
</head>
<body>

  <div ng-view></div>

</body>
</html>

这段代码中,我们新增了两个<script>标签,它们是用来加载额外的Javascript的:

  • angular-route.js: 定义了Angular 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控制器中被定义)表达式的。

本章我们将一起学习:

  • 如何创建一个布局模版
  • 如何如何创建一个多视图路由应用
  • 如何使用ngRoute指令实现视图路由

我们先看看本章对应的例子要做的事情是什么:

  • 当你点击导航栏导航到app/index.html时,你将被重定向到app/index.html/#/phones,它会显示手机列表。
  • 当你点击一个手机链接时,URL地址栏的地址变化(显然),新的页面将显示手机的一些信息。

下面我们把代码切换到step-7:

git checkout -f step-7

假设你已经运行了网站,你只需要刷新你的浏览器来看效果。或者你可以在线看效果

相关依赖

我们通过ngRoute指令实现视图路由技术,它不属于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.2.1",
    "bootstrap": "~3.1.1",
    "angular-route": "1.4.x"
  }
}

"angular-route": "1.4.x" 这句话告诉bower安装1.4.x版本的Angular路由插件。我们需要保证路由插件的成功安装。
如果你已经全局安装了bower管理器,你可以通过bower install来安装所有的依赖。但是对于本项目来说,我们已经在npm脚本中配置了bower install的执行,所以我们只需要运行:

npm install

注意:如果你运行上述命令后,恰好一个新的Angular版本发布了,这时候,bower install命令可能会执行失败,因为新旧版本的AngularJS有冲突。如果你遇到了这个问题,你只需要删除你的app/bower_components文件夹,再次运行npm install

多视图,路由技术和布局模版

我们的应用内容越来越丰富了。在本章之前,应用只有一个视图(手机列表),并且所有的模版代码都在index.html文件中。下面我们将为列表中的每一个手机添加一个详情视图。
我们可以直接把详情视图添加到inde.html中,但是这样做会让index.html变得特别大,看起来会很糟糕。所以我们换一种做法,我们将把index.html分解成布局模版。这个模版适用于本应用中的所有页面(注解:这和sitemesh、velocity、apache Tiles等服务端模版技术对应)。其他的局部模版将根据当前的路由被选择性的集成到当前模版中,从而最终呈现给用户。
Angular使用$routeProvider来申明应用应用路由,它是$route service的提供者。这个服务可以很容易的把控制器、视图模版和当前的URL地址绑定在一起。通过这个特性,我们可以实现deep linking,通过它我们可以利用浏览器的历史功能(往后和前进)以及书签功能。

探讨下依赖注入、注入器和提供者

依赖注入功能是AngularJS的核心功能,所以了解一点它的知识是有必要的。
当应用启动时,AngularJS将先创建一个注入器,它将寻找并且注入应用所需要的所有服务。注入器本身是不知道$http或者$route服务是干嘛的。实时上,注入器都不知道它们的存在,除非他们被依赖进来。
注入器只完成以下几个步骤:

  • 加载应用中指定的模块定义
  • 注册模块定义中所有的提供器(提供者)——配置阶段
  • 当需要的时候,注入服务或者提供者延迟初始化的依赖等。——运行阶段

提供者的功能为创建服务实例和暴露配置API,后者包括控制服务的创建和运行时行为。在$route服务中,$routeProvider暴露一些允许你定义路由的API。

注意:提供者只能在config函数里被注入。所以你无法把$routeProvider注入到PhoneListCtrl中。

Angular模块解决了移除应用全局状态的问题,并且提供了一个配置注入器的方式。跟AMD或者require.js不一样的是,Angular模块不会去解决脚本加载顺序或者延迟脚本获取的问题。这些目标是相互独立的,他们可以共同工作于一个系统中,各自完成自己的目标(意思就是AngularJS和AMD或者require.js框架可以公用)。
如果你想进一步了解Angular中的依赖注入,可以看看这里:理解依赖注入.

模版

$route指令通常和$ngView指令结合使用。$ngView指令所扮演的角色是把当前路由对应的视图模版加入布局模版中。所以这里使用它正好。

注意:从AngularJS 1.2起,ngRoute就是Angular的自有模块了,而且必须通过加载另外的angular-route.js文件来完成载入(由Bower下载)

app/index.html

<!doctype html>
<html lang="en" ng-app="phonecatApp">
<head>
...
  <script src="bower_components/angular/angular.js"></script>
  <script src="bower_components/angular-route/angular-route.js"></script>
  <script src="js/app.js"></script>
  <script src="js/controllers.js"></script>
</head>
<body>

  <div ng-view></div>

</body>
</html>

这段代码中,我们新增了两个<script>标签,它们是用来加载额外的Javascript的:

  • angular-route.js: 定义了Angular 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(如下所示):
app/js/app.js:

var phonecatApp = angular.module('phonecatApp', [
  'ngRoute',
  'phonecatControllers'
]);
...

我们把angular-route.js文件引入了index.html,并且在controllers.js中新建了一个phonecatControllers模块。然而这些该不足以让我们可以使用ngRoute模块和phonecatControllers模块。我们还需要把他们作为应用的依赖引入进来。像上述代码一样,我们把这两个模块引入本应用,这样我们就可以使用它们提供的指令和服务了。
注意上述代码中第二个参数“['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'}): 其他情况下,将跳转到手机列表页。

为了展示手机详情视图的展示,我们重用了前面几章中创建的PhoneListCtrl控件,并且添加了一个新的PhoneDetailCtrl控制器。这些改变都在app/js/controllers.js中。
我们来看看第二个路由申明中的:phoneId参数。$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模块中也是可以理解的。

测试

为了自动测试所有东西都被成功绑定了,我们需要写一些E2E(端到端)的测试用例来验证不通的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命令来观察测试运行。

实验小能手

{{orderProp}}数据绑定加入到index.html,你会发现什么都没变,在手机列表视图中也一样。这是因为orderProp模型的属于PhoneListCtrl域,对应绑定的HTML元素是<div ng-view>。如果你把它加入到phone-list.html模版中,就能正常工作了。

总结

我们已经实现了多视图和路由功能,下面一章我们将实现详细的手机详情视图。

相关文章

网友评论

  • 面试小集:同学,问一个问题,目前有一个使用angular做的单页webapp,现在需要在ios和android原生app中嵌套webapp的一个页面或者一个模块,比如,抽奖页面或者个人中心模块,问题是,每次加载页面或者模块的时候都会加载整合webapp,导致很慢,这个有什么好的解决办法吗?

本文标题:【一起学AngularJS】第九章、多视图和视图路由

本文链接:https://www.haomeiwen.com/subject/ugwmlttx.html