AngularJS实战项目（Ⅰ）--含源码

前言

钻研ABP框架的日子，遇到了很多新的知识，因为对自己而言是新知识，所以经常卡在很多地方，迟迟不能有所突破，作为一个稍有上进心的程序员，内心绝对是不服输的，也绝对是不畏困难的，心底必然有这样一股力量“I must conquer it!”。比如，以前没用过AutoMapper,那我就去学，最后将学到的写成了博客，和大家一起分享，争取让那些还没接触的人少走弯路。现在，在前端设计时，ABP很多用到的都是AngularJS，而之前做项目都是用的JQuery，所以继续研究ABP也是相当有阻力。但是，不能因为有阻力就拖延，最终导致半途而废吧！因而，还是得学，毕竟技多不压身嘛！况且，JQuery是MPA【经典】，而AngularJS是SPA【年轻】，这两种框架都掌握了，也算是挺圆满的吧。

现在回到正题，这篇博客，我们将会看到如何使用AngularJS创建Web应用。对初学者而言，涵盖并解释一些AngularJS框架的基本特征。我设计了一个简单的关于产品的CRUD的例子，解释了演示中所有的代码片段。

背景

当前，AngularJS作为Javascript的MVC（也有人说是MV*，暂且不纠结这个）框架被广泛使用，它为更快且更容易地开发响应式的Web提供了强大的机制。作为MVC框架，它将Web前端代码分成三个组件Model，View和Controller。因此，在data model,应用逻辑（Controllers）和view展示之间有明确的分离，让你更容易地关注关键的开发区域。view接收来自model的数据来展示。当用户通过点击或者敲击键盘和应用交互时，controller通过改变模型中的数据进行响应。最终，view得到了发生在model中的变化这个通知，从而它能更新展示的内容。

在Angular应用中，view是DOM（文档对象模型），controller是javascript类，model数据存储在对象属性中。AngularJS将集成在客户端的html和数据传输给浏览器。就像Jquery库一样，为了使用新鲜的model状态更新UI，你必须和DOM交互。例如，无论你何时观察到model中的任何改变，你都必须和DOM交互来影响这个改变（如果以前经常使用Jquery，那么这句话不难理解）。然而，AngularJS提供了数据绑定，我们不必将数据从一个地方移到另一个地方，只需要使用javascript属性映射UI部件，然后它就会自动同步了。

使用代码

源代码下载

现在开始写代码，让我们一步一步地创建这个简单的CRUD操作案例。

添加一个index.html页面，并添加一个属性ng-app属性，例如：

<html ng-app="demoApp">

这句代码就将我们的应用定义为AngularJS应用。因为AngularJS是SPA（单页面应用）框架，所以它会使用html视图模板作为分部视图来响应确定的路由。为了渲染一个分部视图，我们会给一个div标签添加一个ng-view属性，所有的分部视图都会渲染在这个div标签中。

<div ng-view=""></div>

下载两个文件angular.js 和angular-route.js，在index.html中添加这些文件的引用。或者你也可以用CDN的静态资源，比如百度CDN的静态资源http://apps.bdimg.com/libs/angular.js/1.4.6/angular.js：

<script src="../Scripts/angular.min.js"></script>
<script src="../Scripts/angular-route.min.js"></script>

分部视图

现在来点我们CRUD案例的真实的内容，我们会开发两个分部视图，ProductList.html和ProductEdit.html。先来看一下ProductList.html的代码：

<div class="container">
    <h2 class="page-title">产品列表</h2>

    <div class="searchbar">
        <ul class="entity-tabular-fields">
            <li>
                <label>搜索：</label>
                <span class="field-control">
                    <input type="text" ng-model="filter.productName" value=" " />
                </span>
                <label></label>
            </li>
        </ul>
    </div>
    
    <h2><a href="#/ProductEdit">新增产品</a></h2>
    
    <table class="items-listing">
        <thead>
            <tr>
                <th>代码</th>
                <th>名称</th>
                <th>描述</th>
                <th>类别</th>
                <th>操作</th>
            </tr>
        </thead>
        <tbody>
            <tr ng-repeat="product in products|filter:filter.productName"> 
                <td><a href="#/ProductEdit?code={{product.code}}">{{product.code}}</a></td>
                <td>{{product.name}}</td>
                <td>{{product.description}}</td>
                <td>{{product.category}}</td>
                <td><a href="#/?code={{product.code}}">删除</a></td>
            </tr>
        </tbody>
    </table>
</div>

效果图：

image

除了html和css，更要关注angular指令的使用。在<tbody>中，我们使用了指令ng-repeat="product in products | filter:filter.productName"。products是一个javascript数组，它是存储在内存中的。该指令告诉javascript循环遍历数组中的每个元素（如果你使用过C#的话，那么它就相当于C#中的foreach），并且为每个元素生成一个<tr>标签。接下来，我们添加了过滤器，该过滤器根据productName过滤出我们搜索条件中要求的一些元素，也许正如你看到的，它是一个对象属性，该属性通过数据绑定指令ng-model="filter.productName"绑定在搜索框上。因此无论你在搜索框中输入什么，产品数组都会使用匹配的字符串过滤。为了输出一些值到html上，我们使用angular的数据绑定语法{{output_Expression}},例如表格单元的产品属性：

<td>{{product.name}}</td>

对于第一个单元格，我们显示了product.code，它会链接到第二个分部视图ProductEdit.html。

最后一个单元格也包含了一个到列表展示页面的链接，它会使用产品代码product.code作为查询字符串。后面我们会看到models/controllers的Javascript代码。现在看一下ProductEdit.html代码：

<div class="container">
    <h2 class="page-title">产品编辑</h2>
    <br/>
    
    <ul class="entity-tabular-fields">
        <li class="entity-field-row">
            <label>产品代码：</label>
            <span class="field-control">
                <input type="text" ng-model="currentProduct.code"/>
                <label></label>
            </span>
        </li>
        <li class="entity-field-row">
            <label>产品名称：</label>
            <span class="field-control">
                <input type="text" ng-model="currentProduct.name" />
                <label></label>
            </span>
        </li>
        <li class="entity-field-row">
            <label>产品描述：</label>
            <span class="field-control">
                <input type="text" ng-model="currentProduct.description"/>
            </span>
            <label></label>
        </li>
        <li class="entity-field-row">
            <label>产品种类：</label>
            <span class="field-control">
                <input type="text" ng-model="currentProduct.category"/>
            </span>
            <label></label>
        </li>
        <li class="entity-field-row">
            <span class="field-control">
                <button ng-click="saveProduct()">保存</button>
            </span>
        </li>
    </ul>
</div>

效果图:

image

注意我们给所有的input标签加了ng-model属性，这个将model（product）属性和相应的UI元素绑定在一起。在这个案例中，会自动地创建一个新的叫做“currentProduct”的产品对象，并且使用用户在文本框中输入的值生成该对象的属性。最后，在button标签中添加了一个ng-click的属性，该属性绑定了按钮的点击事件saveProduct，该事件在当前的$scope中。这个$scope，你可以把它认为一个特殊的Javascript对象，我们当前的视图所有必须的对象或者方法都绑定在$scope上，我们可以从视图中访问在$scope中声明的任何东西。随着我们继续推进model或者controller代码，你会更清楚的。

Javascript/Angular 部分

现在，该看看Javascript部分的代码了。之前已经在index.html中添加了两个AngularJS库的引用，现在再添加一个Javascript文件，我们命名为“App.js”,并将该文件的引用添加到index页面中。

首先，通过调用angular.module声明我们的应用对象。

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

第一个参数“demoApp”是我们定义的模块名称，第二参数是我们的模块必须要有的依赖数组，当前博客的案例中，我们只依赖“ngRoute”。

现在我们为分部视图配置路由：

//配置路由
demoApp.config(function($routeProvider) {
    $routeProvider
        .when('/', {
            controller: "ProductController",
            templateUrl: "partials/ProductList.html"
        })
        .when('/ProductEdit', {
            controller: "ProductController",
            templateUrl: "partials/ProductEdit.html"
        })
        .otherwise({
            redirectTo: '/'
        });
});

参数$routeProvider传到路由配置的函数中，然后使用了一个链式的when函数来寻找url路径，并且传递一个对象来定义和controller相联系的目标视图。Controller属性定义了在templateUrl属性中指定的分部视图会使用哪一个控制器。我们的例子中只使用了一个控制器ProductController。otherwise()函数的作用是，如果没有指定的路径匹配到请求的url路径，就会匹配的默认视图。可以联想一下switch…case…default语法。

是时候定义ProductController了，在AngularJS中，有多种方式定义控制器。我么现在使用一个controllers对象，然后把所有的controller加到这个对象中，最后将这个对象配置给我们app模块的controllers属性。

每一个controller都必须传递一个$scope参数，视图要使用它来访问data model中的数据。在$scope中定义的任何数据都可以在视图中直接访问。如果需要的话也可以使用一些其他可选的参数$route, $routeParams, $location 。

在这个控制器中，我们添加了和ProductFactory交互的支持函数，通过添加到$scope对象中使得这些函数在视图中可以使用。我们用到了一个事件“$viewContentLoaded”，这个事件在分部视图加载到div标签中时触发。因为我们对于添加和编辑任务都是用的ProductEdit页面，因此我将被编辑的产品的code作为查询字符串参数。然后在这个事件中检测查询参数code，如果有此参数，视图就是编辑模式，否则就是一个创建新产品的页面。删除也是类似的原理，如果我们在查询字符串参数中检测到了code，那么就删除产品，然后刷新列表。

你可能会注意到控制器中的另一个参数ProductFactory，这是我们需要从控制器访问数据的服务组件。Angular框架允许用不同的方式创建服务组件。最常用的一种方式是使用工厂创建。我们需要在应用模块中添加该服务，该应用模块包含两个参数：服务名称和工厂函数。别害怕，它不过是一个返回新对象的简单函数。

  1 //定义controllers对象
  2 var controllers = {};
  3 
  4 controllers.ProductController= function($scope,$route,$routeParams,$location,ProductFactory) {
  5     $scope.products = [];
  6 
  7     var init= function() {
  8         $scope.products = ProductFactory.getProducts();
  9     }
 10 
 11     var initProductEdit= function() {
 12         var code = $routeParams.code;
 13         if (code==undefined) {
 14             $scope.currentProduct = {};
 15         } else {
 16             $scope.currentProduct = ProductFactory.loadProductByCode(code);
 17         }
 18     }
 19 
 20     $scope.$on('$viewContentLoaded', function() {
 21         var tempalteUrl = $route.current.templateUrl;
 22         if (tempalteUrl=="partials/ProductEdit.html") {
 23             initProductEdit();
 24         }else if (tempalteUrl=="partials/ProductList.html") {//大小写要和temlateUrl中的大小写保持一致
 25             var code = $routeParams.code;
 26             if (code!=undefined) {
 27                 $scope.deleteProduct(code);
 28             }
 29         }
 30     });
 31 
 32     init();
 33 
 34     $scope.saveProduct= function() {
 35         ProductFactory.saveProduct($scope.currentProduct);
 36         $location.search('code', null);
 37         $location.path('/');
 38     }
 39 
 40     $scope.deleteProduct= function(code) {
 41         ProductFactory.deleteProduct(code);
 42         $location.search('code', null);
 43         $location.path('/');
 44     }
 45 }
 46 
 47 //将所有的控制器赋值给app模块
 48 demoApp.controller(controllers);
 49 
 50 //定义工厂
 51 demoApp.factory('ProductFactory', function () {
 52     //初始化产品数组
 53     var products = [
 54     {code:'P001',name:'Lumia 950XL',description:'win10系统最好的手机，带有黑科技色彩',category:'mobile'},
 55     {code:'P002',name:'Lumia 950',description:'win10系统次好的手机，相比XL低个档次',category:'mobile'},
 56     {code:'P003',name:'Surface Pro Book',description:'微软最具创新的笔记本',category:'Notebook'},
 57     {code:'P004',name:'Surface Pro 4',description:'微软最好的PC/平板二合一产品',category:'Surface'},
 58     { code: 'P005', name: 'Surface 4', description: '微软次好的PC/平板二合一产品', category: 'Surface' },
 59     {code:'P006',name:'Surface Phone',description:'传说中微软下一代win10系统超旗舰手机',category:'mobile'}
 60     ];
 61 
 62     var factory = {};
 63     factory.getProducts= function() {
 64         return products;
 65     }
 66 
 67     factory.loadProductByCode= function(code) {
 68         var productFound={};
 69         for (var i = 0; i < products.length; i++) {
 70             if (products[i].code==code) {
 71                 productFound = products[i];
 72                 break;
 73             }
 74         }
 75         return productFound;
 76     }
 77 
 78     factory.saveProduct= function(product) {
 79         var tempProduct = factory.loadProductByCode(product.code);
 80 
 81         if (tempProduct == null || tempProduct == undefined) {
 82             tempProduct = {};
 83             tempProduct.code = product.code;
 84             tempProduct.name = product.name;
 85             tempProduct.description = product.description;
 86             tempProduct.category = product.category;
 87         } else{
 88             
 89             tempProduct.code = product.code;
 90             tempProduct.name = product.name;
 91             tempProduct.description = product.description;
 92             tempProduct.category = product.category;
 93 
 94             products.push(tempProduct);
 95         }
 96     }
 97 
 98     factory.deleteProduct= function(code) {
 99         var tempProduct = factory.loadProductByCode(code);
100 
101         if (tempProduct!=null) {
102             products.remove(tempProduct);
103         }
104     }
105     return factory;
106 });
点击查看代码

 

如上面的代码，我们使用模块的工厂函数来定义工厂服务组件。代码很明显，它只包含了一些帮助属性和方法。代码末尾的deleteProduct函数使用了一个数组的remove函数，它不是默认的数组函数，我定义了一个函数，把它添加到Array.prototype中，使得它可以在网站中的任何地方都可以访问。但要确保在应用加载的开始处理这个，在一些相关的代码执行之前执行，比如我放到了index.html页面中的script标签中。

在工厂组件中，我们经常必须从server中存取数据，但在这篇博客中，我们只用到了临时的内存中的产品数组。在下一篇博客中，我将从server的数据库中存取数据。

注解：

$route:用于控制器和视图（html分部视图）的深度链接。查看更多。

$routeParams:该服务允许检索当前路由参数的集合。查看更多。

$location:该服务分析浏览器地址栏中的URL（基于window.location），使得该URL对应用可用。查看更多。

 

源代码下载

posted @ 2015-11-12 17:12  tkbSimplest  阅读(32808)  评论(8)  编辑  收藏  举报