Nodejs之MEAN栈开发（五）---- Angular入门与页面改造

这个系列一共会涉及两个JavaScript框架的讲解，一个是Express用做后端，一个是Angular用于前端。和Express一样，Angular分离内容，处理视图、数据和逻辑。和MVC模式很相似，但其实Angular定义是MVW框架，W代表(what ever works for you)。意味着它可以是控制器或者视图模型，或者服务，就看你怎么定义的。这一节会介绍基本的Angular知识；然后改造我们之前做的页面；并且调用之前的定义的api来获取数据。

Angular的数据绑定是指视图的改变会更新模型，而模型的改变也会更新视图。

不像我们用jquery去绑定dom事件然后改变dom。类似于wpf中的双向绑定。

一、第一个例子：数据绑定初体验

这样的例子你可能见得多了，但不要着急，我们循序渐进。

<input />
<h1>Hello </h1>

如何让input中的输入立刻显示在hello的后面？如果是JavaScript或者jquery自然是绑定按键事件，然而Angular都不需要再编写JavaScript代码。先引入

<script src="angular.min.js"></script>
或 <script src="http://apps.bdimg.com/libs/angular.js/1.4.6/angular.min.js"></script>

然后我们还需要告诉Angular这个页面是一个Angular应用，也就是在html标签修改如下：

<html ng-app>

ng-app这个属性其实可以加到任意元素上，这个属性标记了Angular的作用范围。添加在html上，意味着这整个页面Angular都能工作。接下来我们将input绑定到一个模型：myinput，

<input ng-model="myInput" />

接下来再将模型放到我们要输出的地方，Angular使用{{}}来绑定。如下，这里两个地方的名称必须一致。

<h1>Hello {{ myInput }}</h1>

剩下就交给Angular去做了，演示：

这和第一幅图中所表达的意思一致，视图的改变更新了模型，模型的改变又更新了视图。

二、设置模型初始值

感受了Angular的神奇之后，接下来通过给模型一个初始值，来了解更多Angular的相关知识。要达到这个目的，我们需要创建一个Angular应用模块(module)，一个controller来管理作用域。

1.module

<html ng-app="myApp">

module的名称用于标签的ng-app属性。新建一个JavaScript文件，定义如下：

angular.module('myApp', []);

这样就申明了一个Angular应用模块，作用于<html>元素。

2.controller

有了module之后，就可以定义controller了，控制器是在JavaScript代码中定义，附加在某个的html元素上，表示能在这个元素内部工作。如下，我们将控制器附加到body上，命名为myController ：

<body ng-controller="myController">

再看JavaScript部分：

function myController() {
 
};
angular.module('myApp').controller('myController', myController);

定义了一个‘myController’，添加在‘myApp’这个模块中。接下来我们通过scope给模型一个初始值。

3.scope

像JavaScript代码一样，Angular也有作用域，Angular有一个rootScope，类似于JavaScript中的全局作用域，包含整个应用。rootScope包含一个或多个子作用域，例如 ng-controller 指令就会创建一个子作用域。作用域关联着视图、模型和控制器。上面定义的myController方法可以带一个$scope参数，且必须为这个名字。它代表着作用域，Angular已自动创建。通过这个参数可以获取到模型。这样，设置初始值就简单了：

var myController = function ($scope) {
    $scope.myInput = "Angular!";
};

这种感觉就是依赖注入，$scope由$scopeProvider提供。再看下效果：

输入框和h1元素都出现了模型的初始值。

三、页面改造

Angular是运行于客户端的JavaScript文件，我们需要告诉Express框架，在请求Angular的脚本文件时当成静态文件传送就行，而不需要运行它。Public文件夹已经设置为静态。

app.use(express.static(path.join(__dirname, 'public')));

所以可以在public文件下新建一个angular文件夹，放置Angular脚本文件，并新建一个readApp.js. 在里面定义：

angular.module('readApp', []);

然后在layout.jade里添加文件：

    script(src='/angular/angular.min.js')
    script(src='/angular/readApp.js')

html(ng-app='readApp')

这样意味着所有页面都支持Angular了。但如果要用Angular展示数据，那么Angular得先拿到数据（不再使用jade去渲染视图），实现这个有三步

1）拿掉Express中对应的首页控制器中的api的调用。

2）在Angular应用的scope中添加编码。

3）更新视图模板并绑定到Angular数据。

第一步，可以先注释掉index方法中请求api的代码，直接返回视图,给Angular腾出场子。

module.exports.index = function (req, res) {
    //var requestOptions, path;
    //path = "/api/topics";
    //requestOptions = {
    //    url: apiOptions.server + path,
    //    method: "GET",
    //    json: {},
    //}
    //request(requestOptions, function (err, response, body) {
    //    if (response.statusCode == 200) {
    //        res.render('index', { title: 'Index', topics: body });
    //    } else {
    //        res.render('error', { message: err.message, error: err });
    //    }
    //});
    res.render('index', { title: 'Index' });
};

第二步再在readApp.js中增加一个控制器，先用静态数据：

var topics = [
    {
        title: "书山有路第十一期：程序员修炼之道-第八章-注重实效的项目--第二十二天",
        type: "读书",
        visitedCount: 80,
        commentCount: 2,
        createdOn: '2016/7/05 21:32',
        author: 'stoneniqiu',
        img: 'http://upload.jianshu.io/users/upload_avatars/133630/d5370e672fd4.png?imageMogr/thumbnail/90x90/quality/100'
    },
    {
        title: "《明朝那些事儿》之闲言散语",
        type: "书评",
        visitedCount: 180,
        commentCount: 20,
        createdOn: '2016/5/15 21:32',
        author: '卡卡卡萨布兰卡 ',
        img: 'http://upload.jianshu.io/users/upload_avatars/1675188/2d0810ccc03d.jpg?imageMogr/thumbnail/90x90/quality/100'
    },
    {
        title: "有《程序员修炼之道》高清版吗？",
        type: "求书",
        visitedCount: 90,
        commentCount: 1,
        createdOn: '2016/5/15 21:32',
        author: '吾不知 ',
        img: 'http://upload.jianshu.io/users/upload_avatars/1125491/3910f3825f73.jpg?imageMogr/thumbnail/90x90/quality/100',
    }];

var homeController = function($scope) {
    $scope.data = topics;
};

并注册：

angular.module('readApp')
    .controller('homeController', homeController)

第三步：更新视图（index.jade）

   .col-md-9.page(ng-controller="homeController")
     .row.topictype
       a.label.label-info(href='/')  全部
       a(href='/') 读书
       a(href='/') 书评
       a(href='/') 求书
       a(href='/') 求索
     .row.topiclist(ng-repeat='topic in data')
          img(ng-src='{{topic.img}}')
          span.count
            i.coment {{topic.commentCount}}
            i /
            i {{topic.visitedCount}}
          span.label.label-info {{topic.type}}
          a(href='/') {{topic.title}}
          span.pull-right {{topic.createdOn|formdate}}
          a.pull-right.author(href='/') {{topic.author}}

我们将homeController加载.page这个元素上。在第二步里面，我们定义了一个Data的模型，其实是一个数组集合，这里用

(ng-repeat='topic in data')

循环输出。代替了jade的each语法：‘each topic in topics‘，和jade不同的是，jade的循环语句位于.topiclist的上方，而Angular的repeat指令要添加在你需要重复的元素了。然后还要注意的是，所有的元素内容中的{{}}前的等号要拿掉，换成空格赋值的语法（等号表示变量，空格表示是字符串），不然无法输出。再注意一个是img的src要用ng-src，不然不能输出url。这个时候运行，已经可以看见输出了：

4.filter

大家可能留意到，上面有这样一段代码：

 {{topic.createdOn|formdate}}

属性的后面跟上|号和一个名字，这就叫过滤器(filter)，故名思议，通过特定的规则，将源数据转换成需要的数据格式。这里的formdate的定义是：

var formdate = function() {
    return function(dateStr) {
        var date = new Date(dateStr);
        var d = date.getDate();
        var monthNames = ["1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12"];
        var m = monthNames[date.getMonth()];
        var y = date.getFullYear();
        var output = y + '-' + m + '-' + d;
        return output;
    };
};
angular.module('readApp')
    .controller('homeController', homeController)
    .filter('formdate', formdate)

形式上和注册controller是一样，不同的是，filter需要返回一个函数。其实Angular自带一些数据格式，比如data，currency等。如下

<div>{{50.25|currency }}</div>
$50.25
 <div>{{50.25|currency:'￥' }}</div>
￥50.25

    <div>{{ "Let's shout" | uppercase }}</div>
    <!-- 输出: LET’S SHOUT -->
    {{ timestamp | date:"d MMM yyyy" }}
    <!-- 输出: 21 Aug 2014 -->

5.directive

指令主要是用来创建html片段，一个html代码片段可以被多个不同的controller和view使用，这容易保持一致性且容易维护。这些片段运行在Angular应用的上下文中，照样可以使用数据绑定，而且浏览器可以缓存这些指令为html文件，当用户在不同的view来回切换时，这有利于加速应用。接下来演示如何添加一个指令，改造之前显示星星的部分（切换到books.jade）。

先模拟的个数据，在homeController中加入models

  $scope.models = [{ rating: 4 }, { rating: 5 }];

然后定义一个ratings指令：

var ratingStars = function () {
    return {
        template : "{{book.rating}}",
    };
};

并注册，

angular.module('readApp')
    .controller('homeController', homeController)
    .filter('formdate', formdate)
    .directive('ratingStars', ratingStars)

在视图上输出。这里有一个注意的地方，html属性是大小写不敏感的，驼峰式的命名需要用转换一下，也就是ratingStars 匹配的是rating-stars，即大写字母转成'-' 加小写字母。

 p(ng-repeat='book in models')
      small(rating-stars)

页面上会输出4和5.这自然还不能满足我们的要求。有两点：1属性名限制的太死了，不能总是'book.rating'。2是需要把数字变成星星。第一个问题是一个作用域的问题，需要创建一个作用域变量。

 return {
        scope: {
            thisRating : '=rating'
        },
        template : "{{ thisRating }}"
    };

创建了一个thisRating的作用域变量，而'=rating'告诉Angular去匹配带有‘rating'的属性。然后在Angular文件夹下创建一个rating-stars.html。

<span class="glyphicon glyphicon-star{{ thisRating<1 ? '-empty' : ''}}"></span>
<span class="glyphicon glyphicon-star{{ thisRating<2 ? '-empty' : ''}}"></span>
<span class="glyphicon glyphicon-star{{ thisRating<3 ? '-empty' : ''}}"></span>
<span class="glyphicon glyphicon-star{{ thisRating<4 ? '-empty' : ''}}"></span>
<span class="glyphicon glyphicon-star{{ thisRating<5 ? '-empty' : ''}}"></span>

然后用templateUrl指向这个片段

var ratingStars = function () {
    return {
        scope: {
            thisRating : '=rating'
        },
        templateUrl: '/angular/rating-stars.html'
    };
};

在视图上运用：

p(rating-stars, rating=book.rating)

得到星星

指令的这个scope显得不是很方便。最开始用模拟数据是因为 small(rating-stars) 这种写法不识别jade中的循环(each book in books)中的book对象，而'p(rating-stars, rating=book.rating)'又能识别。

6.service

service在Angular中应用比较多，大部分的应用逻辑都可以用service来实现，而且可以给多个controller调用。接下来将controller的中数据移到一个service中去，然后让controller调用service。

创建一个方法，命名为topicData，用来返回topic数据。

var topicData = function ($http) {
      return topics;
};

注册service：

 .service('topicData', topicData);

使用service：

var homeController = function($scope, topicData) {
    $scope.data = topicData;
};

不要忘记在参数里面加入需要调用的服务名称。到现在完成了一个服务的调用，接下来我们从api来获取数据。JavaScript发送http请求不是什么新鲜事了，Jquery的ajax，node里面的request模块，而Angular有一个自带的服务：$http,用来处理请求。接下来就用它来请求api。

var topicData = function ($http) {
   return $http.get('/api/topics');
};

$http有一个get方法，参数就是一个url。这里调用我们在第三节定义好的api。--> 使用Mongoose创建模型及API

这是一个异步的方法，所以还需要改造Controller中的代码：

var homeController = function ($scope, topicData) {
    topicData.success(function (data) {
        console.log(data);
        $scope.data = data;
    }).error(function (e) {
        console.log(e);
 });
};

这时候运行，可以看到全部的数据了。

异步加载数据的一个问题是用户刚打开页面的时候可能是一片空白，所以加一个过渡的内容好一点。

var homeController = function ($scope, topicData) {
    $scope.message = "loading...";
    topicData.success(function (data) {
        console.log(data);
        $scope.message = data.length > 0 ? "" : "暂无数据";
        $scope.data = data;
    }).error(function (e) {
        console.log(e);
        $scope.message = "Sorry, something's gone wrong ";
 });
};

页面加一个：

 .error {{ message }}

这样避免出现一个短时间的空白。

小结：这一节我们体验了Angular的数据绑定模式，并学习了如何定义并使用module、Controller、directive、filter和service。简单了改造了首页，将Express的一部分工作转移到了前端。其实涉及到Angular的每一个部分都不够深入，只是按需分配，用到多少就讲多少。我觉得这样循序渐进的比较好。下一节将介绍用Angular做一个单页应用(SPA),讲解Angular路由等知识。