AngualrJS之自定义指令

一、指令

指令directive是AngularJS的核心之一

包括
　　- 用于扩展HTML元素、属性的指令
　　- 执行特定功能的指令
　　- 自定义指令

内置指令基本上都是以ng-开头

二、内置指令

1、属性指令

ng-href：代替a标记的href属性
ng-src：代替img等标记的src属性
ng-disabled：设置表单元素是否可用
ng-checked：设置选项是否选中
ng-readonly：设置文本元素是否只读
ng-selected：设置下拉选项是否选中
ng-class：设置class属性
ng-style：设置style属性，应该是对象或JSON

2、功能指令

ng-app：设置当前元素是 AngularJS根元素

ng-controller：用于为应用添加控制器

ng-include：用于包含外部的HTML文件

ng-if：用于在表达式为false时移除HTML元素

ng-switch：根据表达式显示或隐藏对应的部分

ng-repeat：用于循环输出指定次数的HTML元素

ng-init：执行给定的表达式

ng-bind：使用给定的变量或表达式的值来替换HTML元素的内容

ng-bind-template：与上类似，可绑定多个

ng-cloak：用于在应用加载时防止代码未加载完而出现AngularJs表达式的问题

ng-model：用于绑定表单元素到作用域变量中(双向绑定)

ng-hide/ng-show：在表达式为true时隐藏/显示HTML元素

ng-form：增强HTML表单

ng-change：类似于onchange事件

ng-click：类似于onclick-事件

ng-submit：类似于onsubmit事件

三、自定义指令

1、概述

使用directivej方法可以自定义指令，语法:模块对象.directive(“指令名”,[注入内容,回调函数]);

指令名采用骆驼命名法，使用时将驼峰名称改写为短横线连接的名称，如定义时为: itFirst，则使用时为it-first；第一个词不建议使用ng

回调函数返回一个JSON对象，该对象包括了自定义指令的配置，即指令对象定义

指令对象定义是一个JSON格式，包含大量指令配置项

2、指令的生命周期

加载阶段：以ng-app为入口，确定 EAngularJSt的应用范围

编译阶段：遍历应用范围，找到所有指令，根据指令的定义进行DOM转换(由template、templateUrl、replace等配置项决定)，如果指令有compile函数则调用

链接阶段：应用范围内的每条指令运行link函数，如果有DOM操作，也应该在link函数中执行

3、指令配置项

restrict：字符串，指令以何种形式使用，‘A’ 表示属性Attribute ， ‘E’ 表示元素Element 、 ‘C’ 表示类Class 、‘M’ 表示注释Comment( 需加directive:)，也可以是它们的组合形式。默认值为AE ，可以通过元素名和属性名来调用指令。

template：一段HTML 文本或返回一个HTML 文本的函数，用来填充指令内容，当replace为true时结果必须有且仅有一个根元素 。如果页面中多个指令的模板基本相同，可以使用$templateCache 进行缓存后再使用

replace：布尔，是否替换原有元素，默认false

templateUrl：指定外部模板文件的路径，或返回路径的函数，用于代替template

transclude：是否包含原有内容，设置为true 时，可在template中使用ng-transclude指令获取原有内容，即需要 配合ng-transclude 指令使用

priority：指定同一元素上多个指令的controller调用的优先级，数值类型，值越大优先级越高，默认为0

terminal：同一元素上优先级比本指令低的指令或低层次的指令是否执行，布尔类型

scope：表示指令的作用域，取值有三种（false 、true 、{} 空对象），false 表示继承父作用域，同一个作用域；默认值true表示从父作用域继承并创建一个新作用域；{} 空对象表示隔离作用域，默认无法访问父作用域，但可以通过配置绑定( 隔离) 策略，

将父作用域中指定数据绑定到隔离作用域中，绑定策略有三种形式：@：单向，父作用域影响隔离作用域，将属性作为字符串传递；=：双向， 父作用域与隔离作用域相互影响，将属性按原类型传递；&：方法的访问形式，注意传参数的写法，

必须以对象形式传递可以在以上符号的后面指定绑定的名称( 属性名)，也可省略简写

link：回调函数，用于处理数据、DOM，可以接受四个参数，分别是作用域scope、元素element、属性attribute、依赖的其它指令控制器controller；出于通用性考虑，scope提供$apply(“ 函数名()”)的形式调用函数，函数名可通过属性传递

controller：不同于之前的控制器，是指令自身的控制器，用于向外部公开指令所具有的方法

require：字符串，表示所依赖的其它指令名称，此时会将其它指令的控制器注入进link函数，作为第4个参数；指令名称前可以添加符号：^ 表示会在上层指令中查找，?表示找不到则传入null，可以组合成?^