AngularJS中文参考手册 /AngularJS 指令

AngularJS 指令


AngularJS 通过被称为指令的新属性来扩展 HTML。

AngularJS 通过内置的指令来为应用添加功能。

AngularJS 允许你自定义指令。


AngularJS 指令

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

ng-app指令初始化一个 AngularJS 应用程序。

ng-init指令初始化应用程序数据。

ng-model指令把元素值(比如输入域的值)绑定到应用程序。

完整的指令内容可以参阅 AngularJS 参考手册。

实例

     
  

在输入框中尝试输入:

姓名:

你输入的为: {{ firstName }}


运行实例 »

点击 "运行实例" 按钮查看在线实例

ng-app指令告诉 AngularJS,

元素是 AngularJS应用程序的"所有者"。

Note 一个网页可以包含多个运行在不同元素中的 AngularJS 应用程序。

数据绑定

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

AngularJS 中的数据绑定,同步了 AngularJS 表达式与 AngularJS 数据。

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

在下一个实例中,两个文本域是通过两个 ng-model 指令同步的:

实例

     
  

价格计算器

数量: 价格:

总价: {{quantity * price}}


运行实例 »

点击 "运行实例" 按钮查看在线实例

Note 使用ng-init不是很常见。您将在控制器一章中学习到一个更好的初始化数据的方式。

重复 HTML 元素

ng-repeat指令会重复一个 HTML 元素:

实例

     
  

使用 ng-repeat 来循环数组

  • {{ x }}

运行实例 »

点击 "运行实例" 按钮查看在线实例

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

实例

     
  

循环对象:

  • {{ x.name + ', ' + x.country }}

运行实例 »

点击 "运行实例" 按钮查看在线实例

Note AngularJS 完美支持数据库的 CRUD(增加Create、读取Read、更新Update、删除Delete)应用程序。
把实例中的对象想象成数据库中的记录。

ng-app 指令

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

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

稍后您将学习到ng-app如何通过一个值(比如 ng-app="myModule")连接到代码模块。


ng-init 指令

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

通常情况下,不使用 ng-init。您将使用一个控制器或模块来代替它。

稍后您将学习更多有关控制器和模块的知识。


ng-model 指令

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

ng-model指令也可以:

  • 为应用程序数据提供类型验证(number、email、required)。

  • 为应用程序数据提供状态(invalid、dirty、touched、error)。

  • 为 HTML 元素提供 CSS 类。

  • 绑定 HTML 元素到 HTML 表单。


ng-repeat 指令

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



创建自定义的指令

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

你可以使用.directive函数来添加自定义的指令。

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

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

实例

     
     

运行实例 »

点击 "运行实例" 按钮查看在线实例

你可以通过以下方式来调用指令:

  • 元素名

  • 属性

  • 类名

  • 注释

以下实例方式也能输出同样结果:

元素名

实例

     
     

运行实例 »

点击 "运行实例" 按钮查看在线实例

属性

实例

     
  

运行实例 »

点击 "运行实例" 按钮查看在线实例

类名

实例

     
  

注意: 你必须设置 restrict 的值为 "C" 才能通过类名来调用指令。


运行实例 »

点击 "运行实例" 按钮查看在线实例

注释

实例

     
    

注意: 我们需要在该实例添加 replace 属性, 否则评论是不可见的。

注意: 你必须设置 restrict 的值为 "M" 才能通过注释来调用指令。


运行实例 »

点击 "运行实例" 按钮查看在线实例


限制使用

你可以限制你的指令只能通过特定的方式来调用。

实例

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

实例

    
   

注意: 通过设置 restrict 属性值为 "A" 来设置指令只能通过 HTML 元素的属性来调用。


运行实例 »

点击 "运行实例" 按钮查看在线实例

restrict值可以是以下几种:

  • E作为元素名使用

  • A作为属性使用

  • C作为类名使用

  • M作为注释使用

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