angularJS学习笔记（二）

前言

首先，了解 一下ng的一些概念：

• module 代码的组织单元，其它东西都是定义在具体的模块中的。
• app 应用业务，需要多个模块的配合完成。
• service 仅在数据层面实现特定业务功能的代码封装
• controller 与DOM结构相关联的东西，即是一种业务封装概念，又体现了项目组织的层级结构
• filter 改变数据的一种机制
• directive 与DOM结构相关联，特定功能的封装形式

上面的这些概念基本上就是ng的全部。每一部分都可以自由定义，使用时通过各种要素的相互配合来实现我们的业务需求。

模块(module)

每个ng应用都默认加载一个模块“ng”,该组件内部提供了一些常用的功能，我们可以直接使用使用他们，但这些功能可能没法完成我们的需求。因此ng另外还封装了一些其它模块，如ngAnimate、ngResource、ngRoute等，这些模块分别提供了一些各不相同的功能，注入进来我们就可以完全使用他们。我们也可以通过angular.module来创造、注册和加载模块。
一个模块是 一组服务，指令，控制器，过滤函数和配置信息的集合。

angular.module

我们可以通过angular.module(name, [requires], [configFn])创造一个模块。模块名是绑定到模板中ngApp值，requires是需要依赖加载的模块，configFn是requires加载完成之后的初始化工作。返回一个带有其它方法和属性的模块。

• provider() $provide.provider()的引用
• factory() $provide.factory()的引用
• service() $provide.service()的引用
• value() $provide.value()的引用
• constant() $provide.constant()的引用
• decorator() $provide.decorator()的引用
• animation() 自定义动画指令,$animateProvider.register()的引用
• filter() 自定义过滤指令，$filterProvider.register()的引用
• controller() 自定义控制器,$controllerProvider.register()的引用
• directive() 自定义指令,$compileProvider.directive()的引用
• config() 配置函数
• run() 应用初始化
• name 模块名
• requires 依赖模块数组

自定义服务$provide

当你想在当前模块的控制器去引用另一模板的控制器功能时，可以自定义一个相关服务，然后在需要该服务的控制器中显示声明依赖该服务，这样就可在多个控制器中使用同一段逻辑代码。
ng提供服务的过程涉及它的依赖注入机制。而$provide服务内置一些使用$injector注册服务的方法。
(1)provider方法：注册一个服务提供函数。
该函数是一个构造函数，通过内部的$get属性来提供一个服务。

    var fn = function() {
        this.$get = function() {
            return "china";
        };
    }

    var myApp = angular.module(‘myApp‘, [], function($provide) {
        $provide.provider(‘test‘, fn);
    });

    myApp.controller(‘myCtrl‘, function($scope, test) {
        console.log(test);
    });

上面是一种定义服务的方法，不常用，而且我也没搞懂，汗。。。
(2)factory方法
是provider方法的简写，相当于provider(name, {$get:$getFn})，直接把一个函数成是一个对象的$get()方法，这样就不用显示地定义一个provider方法了。 (3)service方法 注册一个服务实例，和factory方法功能相似。区别是factory直接传进$get方法即可，而service方法传入的是一个构造函数。即service返回的是一个对象，而factory方法 可以是一个数字或字符串。例如ng入门实例中的phonecat程序内部定义的ajax服务使用的就是factory方法，返回请求的json字符串。

phonecatServices.factory(‘Phone‘, [‘$resource‘,
  function($resource){
    return $resource(‘phones/:phoneId.json‘, {}, {
      query: {method:‘GET‘, params:{phoneId:‘phones‘}, isArray:true}
    });
  }]);

(3)value方法
相当于provider方法中的$get属性函数不需要参数且直接返回值的情况。provider方法中的test服务例子可直接简写：

myApp.value(‘test‘,"China");

传入值可以是字符串、数字、数组、对象和函数。
(4)constant方法
和value方法功能类似，即给一个服务名绑定一个常量，该常量可以是字符串、数字、数组、对象和函数。区别就是通过constant方法注册的服务能够被注入进module的配置中，而且不能被decorator方法修改。
(5)decorator(name, decorator)方法
中断一个服务的初始化，修改这个服务。参数name是已经定义但需要被修改的服务名。

var myApp = angular.module(‘myApp‘, [])
            .config([‘test‘, function(test) {
                        console.log(test.name);
            }])
            .constant(‘test‘,{name:"constant"})
            .value(‘valueTest‘,{name:‘value‘})
            .decorator(‘valueTest‘, function() {
                return {
                    name: ‘decoration‘
                };
            })
            .controller(‘myCtrl‘, [‘valueTest‘, function(valueTest) {
                console.log(valueTest.name);
            }]);

自定义指令directive

通过前面的学习，我们慢慢发现，ng中的功能都是通过在相应模板中绑定功能的指令来完成。如

<div ng-controller="Controller">
  Hello <input ng-model=‘name‘> <hr/>
  <span ng-bind="name"></span> <br/>
  <span ng:bind="name"></span> <br/>
  <span ng_bind="name"></span> <br/>
  <span data-ng-bind="name"></span> <br/>
  <span x-ng-bind="name"></span> <br/>
</div>

而ng的指令绑定方式有element names,attributes,comment,class names

<my-dir></my-dir>
<span my-dir="exp"></span>
<!-- directive: my-dir exp -->
<span class="my-dir: exp;"></span>

ng不仅提供了一些简单的指令供我们使用，同时也允许我们自定义指令。通过模块中的directiveAPI可以定义指令，而最简单的定义指令方式是直接返回一个函数：

angular.module(‘myApp‘, [])
.directive(‘myLink‘, function($interval, dateFilter) {
                    return function link(scope, element, attrs) {
                        var format,
                                timeoutId;

                        function updateTime() {
                            element.text(dateFilter(new Date(), format));
                        }

                        scope.$watch(attrs.myLink, function(value) {
                            format = value;
                            updateTime();
                        });

                        // 注册$destoty事件，防止内存泄露问题
                        // 当编译的DOM被销毁时触发
                        element.on(‘$destroy‘, function() {
                            $interval.cancel(timeoutId);
                        });

                        // start the UI update process; save the timeoutId for canceling
                        timeoutId = $interval(function() {
                            updateTime(); // update DOM
                        }, 1000);
                    }
                });

指令名必须是驼峰格式的命名，而直接直接返回函数的形式等同于复杂指令定义方式中的返回link函数

angular.module(‘myApp‘, [])
                .directive(‘myCurrentTime‘, function($interval, dateFilter) {

                    function link(scope, element, attrs) {
                        var format,
                                timeoutId;

                        function updateTime() {
                            element.text(dateFilter(new Date(), format));
                        }

                        scope.$watch(attrs.myCurrentTime, function(value) {
                            format = value;
                            updateTime();
                        });

                        // 注册$destoty事件，防止内存泄露问题
                        // 当编译的DOM被销毁时触发
                        element.on(‘$destroy‘, function() {
                            $interval.cancel(timeoutId);
                        });

                        // start the UI update process; save the timeoutId for canceling
                        timeoutId = $interval(function() {
                            updateTime(); // update DOM
                        }, 1000);
                    }

                    return {
                        link: link
                    };
                });

即定义指令的复杂形式是返回一个对象，对象含有以下几种可能用到的属性：

• multiElement
• priority
• terminal
• scope
• controller
• require
• restrict
• templateNamespace
• template
• templateUrl
• replace(ng2.0中会被移除)
• transclude
• compile
• link

在定义复杂的指令形式之前，我们必须了解一下ng对指令的解析和执行过程：

• 浏览器将得到的HTML字符串内容解析成DOM结构
• ng引入，将DOM结构扔给$compile函数处理：
  
  • $compile遍历DOM匹配指令，将指令添加进匹配DOM元素的指令列表中。一个元素可以匹配多个指令。
  • 关联DOM的多个指令按权重排列
  • 指令指令中的compile函数(可修改DOM结构)，返回link函数
  • 得带的所有link函数组成一个列表作为$compile函数的返回
• 指令link函数(连接模板的scope)

下面是一个复杂指令的定义方式：

myApp.directive(‘directiveName‘, function factory(injectables) {
  var directiveDefinitionObject = {
    priority: 0,
    template: ‘<div></div>‘, // or // function(tElement, tAttrs) { ... },
    // or
    // templateUrl: ‘directive.html‘, // or // function(tElement, tAttrs) { ... },
    transclude: false,
    restrict: ‘A‘,
    templateNamespace: ‘html‘,
    scope: false,
    controller: function($scope, $element, $attrs, $transclude, otherInjectables) { ... },
    controllerAs: ‘stringIdentifier‘,
    bindToController: false,
    require: ‘siblingDirectiveName‘, // or // [‘^parentDirectiveName‘, ‘?optionalDirectiveName‘, ‘?^optionalParent‘],
    compile: function compile(tElement, tAttrs, transclude) {
      return {
        pre: function preLink(scope, iElement, iAttrs, controller) { ... },
        post: function postLink(scope, iElement, iAttrs, controller) { ... }
      }
      // or
      // return function postLink( ... ) { ... }
    },
    // or
    // link: {
    //  pre: function preLink(scope, iElement, iAttrs, controller) { ... },
    //  post: function postLink(scope, iElement, iAttrs, controller) { ... }
    // }
    // or
    // link: function postLink( ... ) { ... }
  };
  return directiveDefinitionObject;
});

• multiElement
  当该属性设为true时，HTML编译器会搜集在directive-name-end和directive-name-end之间DOM节点，当作一个集合 作为directive elements使用
• priority
  设置指令的权重，默认为0.当一个DOM元素匹配多个指令时，根据权重的大小来执行相应的指令。
• terminal
  设为true时，当前指令是指令集中的最后 一个会被执行的指令。任何权重值小于当前指令权重的指令都不会被指令。
• scope
  true创建一个新的作用域。{ }创建一个 隔离的scope，可引用相关节点属性：”@attr”引用节点属性，”=attr”把节点属性值引用成scope属性值，“&attr”把节点属性值包装成函数
• controller
  为指令定义一个controller构造函数，允许指令之间彼此通信。function($scope,$element,$attrs,$transclude){}
• require
  引用其它指令的控制器作为link函数的第四个参数。跟一个字符串或者字符串数组。
  
  • (no prefix) 在当前元素内查找控制器
  • ？努力查找或者null
  • ^ 在当前元素和父元素内查找
  • ^^ 在元素的父元素内查找
• restrict
  决定指令的应用方式，默认EA
  
  • E 节点名“`
  • A 属性名
  • C 类值
  • M 注释
• templateNamespace
  模板中的标记。html、svg、math
• template
  模板内容
• templateUrl
  模板地址取代模板内容
• replace
  决定模板内容取代的位置，默认false。true：模板取代指令元素.false:模板取代指令元素的内容。
• transclude
  true或者element
• compile
  function compile(tElement,tAttrs, transclude) 装换模板内容。
• link
  仅当compile属性没有定义时，才会使用。funciton link(scope,iElement,iAttrs,controller,transcludeFn)
  ps：暂时也就只能理解这么多。。。
  可以看官方的一个例子：

<!doctype html>
<html lang="en" ng-app="myApp">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
    <script src="../js/angular.min.js"></script>
</head>
<body>
    <my-tabs>
        <my-pane title="Hello">
            <h4>Hello1</h4>
            <p>Lorem ipsum dolor sit amet</p>
        </my-pane>
        <my-pane title="World">
            <h4>World1</h4>
            <em>Mauris elementum elementum enim at suscipit.</em>
            <p><a href ng-click="i = i + 1">counter: {{i || 0}}</a></p>
        </my-pane>
    </my-tabs>

    <script>
        angular.module(‘myApp‘, [])
                .directive(‘myTabs‘, function() {
                    return {
                        restrict: ‘E‘,
                        transclude: true,
                        scope: {},
                        controller: function($scope) {
                            var panes = $scope.panes = [];

                            $scope.select = function(pane) {
                                angular.forEach(panes, function(pane) {
                                    pane.selected = false;
                                });
                                pane.selected = true;
                            };

                            this.addPane = function(pane) {
                                if (panes.length === 0) {
                                    $scope.select(pane);
                                }
                                panes.push(pane);
                            };
                        },
                        templateUrl: ‘my-tabs.html‘
                    };
                })
                .directive(‘myPane‘, function() {
                    return {
                        require: ‘^myTabs‘,
                        restrict: ‘E‘,
                        transclude: true,
                        scope: {
                            title: ‘@‘
                        },
                        link: function(scope, element, attrs, tabsCtrl) {
                            tabsCtrl.addPane(scope);
                        },
                        templateUrl: ‘my-pane.html‘
                    };
                });
    </script>
</body>
</html>

my-tabs.html

<div class="tabbable">
    <ul class="nav nav-tabs">
        <li ng-repeat="pane in panes" ng-class="{active:pane.selected}">
            <a href="" ng-click="select(pane)">{{pane.title}}</a>
        </li>
    </ul>
    <div ng-transclude></div>
</div>

my-pane.html

<div class="tabbable">
    <ul class="nav nav-tabs">
        <li ng-repeat="pane in panes" ng-class="{active:pane.selected}">
            <a href="" ng-click="select(pane)">{{pane.title}}</a>
        </li>
    </ul>
    <div ng-transclude></div>
</div>

路由ngRoute

ngRoute模块提供了关于路由方面的一些服务和指令。根据URL中的hash部分发生变化时触发在路由服务中预定义的业务逻辑，例如phonecat应用程序中使用到的路由服务：

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‘
      });
  }]);

运行时会发现这些url匹配的都是url的hash部分，eg: http://localhost:8000/app/#/phones

加载路由

由于ng将路由部分单独作为一个模块服务定义，因此在使用相关路由服务之前，需加载引用：

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

angular.module(‘myapp‘,[‘ngRoute‘]);

使用

要使用路由功能，需要在相应的模块初始化阶段通过引用$routeProvider这个服务来定义： （1）$routeProvider.when(path, route)
path参数是将要匹配的路径，可以在路径中定义需要获得的参数，例如“/phones/:phoneId”可以匹配”phones/111”,其中phoneId就是变量，即对应变量前使用”:”匹配。
route是对应路由匹配成功后进行的业务处理对象。包含属性：

• controller 控制器
• template　模板内容
• templateUrl 模板路由
• resolve 可选需要注入进controller中的依赖，是一个对象，对象的key是依赖注入的名，value是string或function
• redirectTo 重定义到新路由

(2)$routeProvider.otherwise(params)
当以上定义的路由都没有匹配时使用。
(3)ngView
HTML模板指令，当相关路由匹配成功时对应的模板内容加载区域。<div ng-view></div>
(4)$routeParams服务 路由中的参数对象。键名为路径中定义的参数名。需要提前加载。 仅当路由完全改变后对应的$routeParams对象才更新。但我们可使用$route.current.params来访问新的路由参数。 (5)$route 控制路由匹配的controllers和views，监控$location.url的变化然后匹配。

• reload() 重新加载
• updateParams(newParams) 使用新的路由参数更新当前路由
• $routeChangesStart 路由改变前的事件
• $routeChangeSuccess 路由成功改变事件
• $routeChangeError 路由改变错误事件
• current 应用当前路由的定义
• routes 当前路由的默认对象

<div ng-controller="MainController">
  Choose:
  <a href="Book/Moby">Moby</a> |
  <a href="Book/Moby/ch/1">Moby: Ch1</a> |
  <a href="Book/Gatsby">Gatsby</a> |
  <a href="Book/Gatsby/ch/4?key=value">Gatsby: Ch4</a> |
  <a href="Book/Scarlet">Scarlet Letter</a><br/>

  <div ng-view></div>

  <hr />

  <pre>$location.path() = {{$location.path()}}</pre>
  <pre>$route.current.templateUrl = {{$route.current.templateUrl}}</pre>
  <pre>$route.current.params = {{$route.current.params}}</pre>
  <pre>$route.current.scope.name = {{$route.current.scope.name}}</pre>
  <pre>$routeParams = {{$routeParams}}</pre>
</div>

另外，$location是ng中默认提供的一个服务：
- absUrl() 当前绝对路径
- url([url]) 更改或获取路径
- protocol() 当前路径协议
- host()
- port()
- path([path])
- search(search,[paramValue])
- hash([hash])

ngResource

ngResource与ngRoute一样，单独的模板，需要提前加载。
ngResource是AJAX服务的一种更高级，抽象的服务，底层仍然调用AJAX服务，该模块是通过$resource提供了和服务端RESTful接口交互支持的服务。

$resource(url, [paramDefaults], [actions], options)

一个创建可以和RESTful服务端交互的resource对象的工厂函数。

• url 可以含有参数
• paramDefaults 默认的url参数值，可以在actions里面被重写
• actions 自定义的方法列表，扩展默认的方法
• options 用户自定义设置
  
  • stripTrailingSlashes 默认为true,省略任何计算的URL后面的斜杠。

phonecatServices.factory(‘Phone‘, [‘$resource‘,
  function($resource){
    return $resource(‘phones/:phoneId.json‘, {}, {
      query: {method:‘GET‘, params:{phoneId:‘phones‘}, isArray:true}
    });
  }]);

ng还提供了一些其它的模块和服务，总之ng在真的很强大，它打破了我们以往按照jQuery+CSS+HTML开发动态网站的思维，将我们带入了另一个全新的世界。

参考

http://www.zouyesheng.com/angular.html

http://www.cnblogs.com/lcllao/archive/2012/10/18/2728787.html