代码改变世界

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

2016-07-08 08:21  stoneniqiu  阅读(2508)  评论(11编辑  收藏

      这个系列一共会涉及两个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',
    }];
View Code
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路由等知识。