AngularJS in Action读书笔记4(实战篇)建Statistic模块

　　个人感觉《Angularjs in action》这本书写的很好，很流畅，循序渐进，深入浅出，关键是结合了一个托管于Github上的实例讲解的，有代码可查，对于初学者应该是个不错的途径。（不是打广告）其实书早已经看完一遍，脑瓜子里面已经存储了一些module、controller、directive、scope等等这些概念，但是怎么把这些东西串起来，用起来，不动手，还是不能检验看书的效果。所以从这篇就来结合自己的实操经验来分享下自己是如何消化（囫囵吞枣）这些概念和设计理念的。

　　设计初衷是要在原来的Angello项目的基础上添加一个模块Statistic，类似于User模块，但是在点进去User后，可以出来一个统计报告，用于显示出该用户每个status（toDo，inProgress，codeReview，qaReview, verified）下各有几个story，并根据这些status的个数绘制一个饼状图（基于D3引擎）。代码已经上传到Github上^^，欢迎来轻拍~~~

　　Github地址：https://github.com/DMinerJackie/angelloExtend （代码持续更新中。。。）

　　最终效果如下：

今天主要内容是一个从无到有，屡屡进坑又出坑过程的分享：

一.搭架子

1. 首先仿照其他模块，新建出statistic模块的目录结构

　　目录中包含了controllers、directives和存放html的tmpl，在statistic目录下新建Statistic.js用于声明一个模块，也就是一个命名空间。包括后面要讲到的DataController.js和D3Chart.js都会包装到这个Angello.Statistic的module中。

angular.module('Angello.Statistic', ['Angello.Common']);

　　2.创建页面和控制器

　　statistic.html

<div class='container chart-wrapper'>
    <h3>User Stories by Type~~~<span ng-model = 'statistic.style'></span>
    123</h3>
    <h3>{{statistic.style}}</h3>
</div>

　　StatisticController.js

angular.module('Angello.Statistic')
.controller('StatisticCtrl', function($scope){
var statistic = this;
statistic.style = '+++++++++++++++++++++++++';
});

　　3.添加路由

　　已经有了要显示的页面，并且statistic.html页面中绑定的变量已经在StatisticController中定义了，但是如果没有路由，我们还是没有办法访问到这个页面。所以需要添加路由，在angello.js文件中加入代码

.when('/statistic',{
        	templateUrl: 'src/angello/statistic/tmpl/statistic.html',
        	controller: 'StatisticCtrl',
        	requiresLogin: true,
        })

　　在不涉及到指令的情况下，做好以上三步，基本就可以如愿的访问Statistis页面了（也就是显示一大串没有意义的“+++++++++++”）。但是这里有些小坑，有一个没填满，都不会出现理想中的界面。

　　（1）每个新建的js文件都要注册

　　我们新创建的控制器StatisticController.js需要到boot.js中注册，即加上一行

{ file: 'src/angello/statistic/controllers/StatisticCtroller.js'},

　　这样的StatisticController.js才是可用，反之如果注释这一行

　　就会看到下面的结果：

　　出现这样的结果说明了什么问题？

　　说明StatisticController控制器没有起到该起的作用，话句话说，就是StatisticController失效，所以需要注册到boot.js以激活使用

　　（2）controlleras参数的使用

　　如果你有读过Angello的代码，你就会发现，在angello的很多模块如users、storyboard等当中都是用了参数controllerAs

　　实验了上面步骤后发现页面是能够正常显示了，之后便渐渐靠近原先的设计，于是将users.html页面全部拷贝到statistic.html中，反复调试都不能像user模块那样显示出用户来，显示界面如下：

　　于是在Angello.js中将原先的路由改为：

.when('/statistic',{
        	templateUrl: 'src/angello/statistic/tmpl/statistic.html',
        	controller: 'StatisticCtrl',
        	controllerAs: 'users',
        	requiresLogin: true,
        })

　　这样就可以正常显示user了。

　　为了弄清楚这个controllerAs参数的使用，将这里的controllerAs:'usesrs'改为了controllerAs:'users123'

　　同时将statistic.html对应的users也改成了users123，代码如下：

<div class='user-wrapper'>
  <form name='users123.userForm'>
      <table class='table edit'>
          <thead>
          <tr>
              <th width='40%'>Name</th>
              <th width='40%'>Email</th>
              <th></th>
          </tr>
          </thead>
          <tbody>
          <tr ng-repeat='user in users123.users'>
              <td>
                <ng-form name='userNameForm'>
                  <input required name='userName' type='text' class='form-control' ng-model='user.name' ng-blusersers1.updateUser(user.id, user)'/>

                  <div class='error' ng-messages='userNameForm.userName.$error'>
                    <div ng-message='required'>
                      Please enter a name.
                    </div>
                  </div>
                </ng-form>
              </td>
              <td>
                <ng-form name='userEmailForm'>
                  <input required name='userEmail' type='email' class='form-control' ng-model='user.email' ng-blur='users123.updateUser(user.id, user)'/>

                  <div class='error' ng-messages='userEmailForm.userEmail.$error'>
                    <div ng-message='required'>
                      Please enter an email.
                    </div>
                    <div ng-message='email'>
                      Email should be in format example@example.com
                    </div>
                  </div>
                </ng-form>
              </td>
              <td>
                <button type='button' class='btn btn-link'
                        ng-click='users123.removeUser(user.id)'>Remove</button>
                <a class='btn btn-link' href='#/users/{{user.id}}'>View</a>
              </td>
          </tr>
          </tbody>
      </table>
  </form>

     <div class='well'>
        <h4>Add User</h4>

        <form name='users123.newUserForm' class='form-inline new-user' role='form' novalidate ng-submit='users123.addUser()'>
            <div class='form-group'>
                <input required name='userName' type='text' class='form-control' ng-model='users123.newUser.name' placeholder='Name'>
                <div class='error' ng-messages='users123.newUserForm.userName.$error' ng-if='users123.showMessages('userName')'>
                    <div ng-message='required'>
                      Please enter a name.
                    </div>
                </div>
            </div>
            <div class='form-group'>
                <input required name='userEmail' type='email' class='form-control' ng-model='users123.newUser.email' placeholder='Email'>
                <div class='error' ng-messages='users123.newUserForm.userEmail.$error' ng-if='users123.showMessages('userEmail')'>
                    <div ng-message='required'>
                      Please enter an email.
                    </div>
                    <div ng-message='email'>
                      Email should be in format example@example.com
                    </div>
                </div>
            </div>
            <button type='submit' class='btn btn-default'>Add</button>
        </form>
    </div>
</div> 

　　如此页面依然正常显示，从而得出结论：controllerAs设定的参数值一定要与页面中的变量同名，否则controllerAs参数失效。另外声明一点，通过使用controllerAs这个参数，避免了$scope的使用，使得在StatisticController.js中大幅减少了$scope的出现，简化了代码。

　　除此以外还有一些细节就不再一一说明，类似页面右上角的那个五角星图标，也就是要做的statistic模块的图标，其实用的是bootstrap的一个类class='glyphicon glyphicon-star'，这也是在仿照其他三个图标时发现并在bootstrap库中选择的一个。所以说这些东西不需要背或记，甚至像我一样对此一无所知，但是需要的时候去查，查到了就用上即可。

　　今天主要讲了如何新建一个模块，从页面到控制器到路由，从页面不显示和不能全部正常显示到页面正常显示出预期的结果，明白了如何创建页面、配合控制器、设置路由等等，当然后面还会继续818如何做到文章开头那幅图的效果~~~