AngularJS 指令

AngularJS 通过指令来扩展 HTML 的功能

AngularJS 内置了丰富的指令可以为应用添加功能

AngularJS 同时允许我们自己自定义指令

AngularJS 指令

AngularJS 指令是扩展的 HTML 属性，带有前缀 ng-

最常见的三个指令：

ng-app 指令初始化一个 AngularJS 应用程序
ng-init 指令初始化应用程序数据
ng-model 指令把元素值（比如输入域的值）绑定到应用程序

<!DOCTYPE html>
<meta charset="utf-8">
<link href="/static/next/css/tryit.css?v=2017082407" rel="stylesheet"/>
<script src="https://cdn.staticfile.org/angular.js/1.6.3/angular.min.js"></script> 

<div ng-app="" ng-init="firstName='John'">

<p>在输入框中尝试输入:</p>
<p>姓名: <input type="text" ng-model="firstName"></p>
<p>你输入的为: {{ firstName }}</p>

</div>
<footer>简单教程，简单编程<br/>Copyright © 简单教程 www.twle.cn</footer>

运行范例 »

ng-app 指令告诉 AngularJS，<div> 元素是 AngularJS 应用程序 的"所有者"

如果想查看完整的指令内容，请移步我们的 AngularJS 参考手册

数据绑定

上面范例中的 {{ firstName }} 表达式是一个 AngularJS 数据绑定表达式

AngularJS 中的数据绑定可以同步 AngularJS 表达式与 AngularJS 数据

{{ firstName }} 是通过 ng-model="firstName" 进行同步

下面的代码中，两个文本域是通过两个 ng-model 指令同步的：

<div ng-app="" ng-init="quantity=1;price=5">
<h2>价格计算器</h2>
数量： <input type="number"    ng-model="quantity">
价格： <input type="number" ng-model="price">
<p><b>总价：</b> {{ quantity * price }}</p>
</div>
<footer>简单教程，简单编程<br/>Copyright © 简单教程 www.twle.cn</footer>

运行范例 »

重复 HTML 元素

ng-repeat 指令用于循环输出一个 HTML 元素

<div ng-app="" ng-init="names=['Jani','Hege','Kai']">
  <p>使用 ng-repeat 来循环数组</p>
  <ul>
    <li ng-repeat="x in names">{{ x }}</li>
  </ul>
</div>
<footer>简单教程，简单编程<br/>Copyright © 简单教程 www.twle.cn</footer>

运行范例 »

ng-repeat 指令用在一个对象数组上

<div ng-app="" ng-init="names=[
{name:'Jani',country:'Norway'},
{name:'Hege',country:'Sweden'},
{name:'Kai',country:'Denmark'}]">

<p>循环对象</p>
<ul>
  <li ng-repeat="x    in names">
    {{ x.name + ', ' + x.country }}
  </li>
</ul>
</div>
<footer>简单教程，简单编程<br/>Copyright © 简单教程 www.twle.cn</footer>

运行范例 »

AngularJS 完美支持数据库的 CRUD（增加 Create、读取 Read、更新 Update、删除 Delete）应用程序

可以把范例中的对象想象成数据库中的记录

ng-app 指令

ng-app 指令定义了 AngularJS 应用程序的 根元素

ng-app 指令在网页加载完毕时会 自动引导 （自动初始化）应用程序

<div ng-app="" ng-init="firstName='John'">
    <p>在输入框中尝试输入:</p>
    <p>姓名: <input type="text" ng-model="firstName"></p>
    <p>你输入的为: {{ firstName }}</p>
</div>
<footer>简单教程，简单编程<br/>Copyright © 简单教程 www.twle.cn</footer>

运行范例 »

接下来我们会学习 ng-app 如何通过一个值（比如 ng-app="myModule"）连接到代码模块

ng-init 指令

ng-init 指令为 AngularJS 应用程序定义了 初始值

<div ng-app="" ng-init="firstName='John'">
    <p>在输入框中尝试输入:</p>
    <p>姓名: <input type="text" ng-model="firstName"></p>
    <p>你输入的为: {{ firstName }}</p>
</div>
<footer>简单教程，简单编程<br/>Copyright © 简单教程 www.twle.cn</footer>

运行范例 »

通常情况下，不使用 ng-init，因为可以使用一个控制器或模块来代替它

我们会在接下来的章节中学习有关控制器和模块的知识

ng-model 指令

ng-model 指令 绑定 HTML 元素 到应用程序数据

<div ng-app="" ng-init="firstName='John'">
    <p>在输入框中尝试输入:</p>
    <p>姓名: <input type="text" ng-model="firstName"></p>
    <p>你输入的为: {{ firstName }}</p>
</div>
<footer>简单教程，简单编程<br/>Copyright © 简单教程 www.twle.cn</footer>

运行范例 »

ng-model 指令也可以:

为应用程序数据提供类型验证（number、email、required）
为应用程序数据提供状态（invalid、dirty、touched、error）
为 HTML 元素提供 CSS 类
绑定 HTML 元素到 HTML 表单

ng-repeat 指令

ng-repeat 指令对于集合中（数组中）的每个项会 克隆一次 HTML 元素

<div ng-app="" ng-init="names=['Jani','Hege','Kai']">
  <p>使用 ng-repeat 来循环数组</p>
  <ul>
    <li ng-repeat="x in names">{{ x }}</li>
  </ul>
</div>
<footer>简单教程，简单编程<br/>Copyright © 简单教程 www.twle.cn</footer>

运行范例 »

创建自定义的指令

除了 AngularJS 内置的指令外，我们还可以创建自定义指令

使用 .directive 函数来添加自定义的指令

要调用自定义指令，HTML 元素上需要添加自定义指令名

使用驼峰法来命名一个指令 ysDirective , 但在使用它时需要以 - 分割 ys-directive

<body ng-app="myApp">
    <ys-directive></ys-directive>
    <script>
        var app = angular.module("myApp", []);
        app.directive("ysDirective", function() {return { template : "<h1>自定义指令!</h1>"};});
    </script>
</body>

运行范例 »

我们可以使用下面几种方式来调用指令

元素名
属性
类名
注释

所以下面几种范例也能输出同样的结果

元素名
```
<ys-directive></ys-directive>
```
运行范例 »
属性
```
<div ys-directive></div>
```
运行范例 »
类名
```
<div class="ys-directive"></div>
```
运行范例 »
注释
```

```
运行范例 »

限制自定义的指令的使用方式

我们可以限制自己定义的指令只能通过特定的方式来调用

方式是通过添加 restrict 属性,并设置值为"A", 来设置指令只能通过属性的方式来调用

var app = angular.module("myApp", []);
app.directive("twleDirective", 
    function() {
        return {        
           restrict : "A",        
           template : "<h1>自定义指令!</h1>"
       };
    }
);

运行范例 »

restrict 值可以是以下几种

E 作为元素名使用
A 作为属性使用
C 作为类名使用
M 作为注释使用

restrict 默认值为EA, 即可以通过元素名和属性名来调用指令

← AngularJS 表达式 AngularJS ng-model 指令 →

AngularJS 指令