AngularJS创建新指令 - 基本功能

指令（Directives）是所有AngularJS应用最重要的部分。尽管AngularJS已经提供了非常丰富的指令，但还是经常需要创建应用特定的指令。

AngularJS原有的指令

ng-init   初始化指令

ng-if   条件指定

ng-repeat   循环指令

等等指令。

原有的指令会单独有一篇文章来说明

下面为大家介绍下创建新指令的方法

加入html代码

<div ng-app="myapp">

<hello-world></hello-world>

<div hello-world></div>

<div data-hello-world></div>

<div x-hello-world></div>

</div>

加入js代码，在渲染ng-app之前。如果不是动态加载angularjs则，把js代码写在html代码前。如果是动态加载angularjs则加在angular.bootstrap(document.body,["myapp"])前面。

angular.module('myapp', []).directive("helloWorld", function () {

        return {

            restrict: "AE",

            replace: true,

            template: "<div>HelloWorld</div>"

        };

    });

在上面的代码中，app.directive()方法在模块中注册了一个新的指令。这个方法的第一个参数是这个指令的名字。第二个参数是一个返回指令定义对象的函数。如果你的指令依赖于其他的对象或者服务，比如 $rootScope, $http, 或者$compile，他们可以在这个时间被注入。这个指令在HTML中以一个元素使用，如下：

<hello-world></hello-world>或<div hello-world></div>

也可以在元素前加上data-或x-，这两个为html5标准

<div x-hello-world></div>或<div data-hello-world></div>

这四种写法都能正常渲染.

而angularjs在匹配指令的时候，会把字符串转换成驼峰(camelCase)表现形式，然后再与注册过的指令进行匹配。

这是为什么，我们在HTML中以 hello-world 的方式使用 helloWorld 指令。

我们在指令定义过程中使用了三个属性来配置指令。

restrict – 这个属性用来指定指令在HTML中如何使用（还记得之前说的，指令的四种表示方式吗）。在上面的例子中，我们使用了 ‘AE’。所以这个指令可以被当作新的HTML元素或者属性来使用。如果要允许指令被当作class来使用，我们将 restrict 设置成 ‘AEC’，即如果用刚刚的

angular.module('myapp', []).directive("helloWorld", function () {

        return {

            restrict: "AEC",

            replace: true,

            template: "<div>HelloWorld</div>"

        };

    });

则<div class="hello-world"></div>也能正常渲染.

replace – 这个属性指明生成的HTML内容是否会替换掉定义此指令的HTML元素。在我们的例子中，我们用 <hello-world></hello-world>的方式使用我们的指令，并且将 replace 设置成 true。所以，在指令被编译之后，生成的模板内容替换掉了 <hello-world></hello-world>。最终的输出是"<div>HelloWorld</div>"，如果你将 replace 设置成 false，也就是默认值，那么生成的模板会被插入到定义指令的元素中。

template – 这个属性规定了指令被Angular编译和链接（link）后生成的HTML标记。这个属性值不一定要是简单的字符串。template 可以非常复杂，而且经常包含其他的指令，以及表达式({{ }})等。更多的情况下你可能会见到 templateUrl， 而不是 template。所以，理想情况下，你应该将模板放到一个特定的HTML文件中，然后将 templateUrl 属性指向它。