NG中的指令,到底是什么(what)? 为什么会有(why)?以及怎样使用(how)?
What: 在NG中,指令扩展HTML功能,为 DOM 元素调用方法、定义行为绑定数据等。
Why: 最大程度减少DOM操作,实现数据绑定,与业务逻辑进行交互。
How: 指令主要分为两种:内置指令和自定义指令,通过下面的例子,简单记录一下如何去使用。
内置指令
在官方API文档上罗列了很多指令,内置指令可以分为:普通指令 和 事件指令,他们都是作用于HTML之上的,通过添加属性的方式来实现的。简单看一下一些常用的指令。
普通指令
ngApp指令
ng-app 指令用来设定一个 AngularJS 应用程序的作用范围的根对象上
系统执行时会自动的执行根对象范围内的其他指令
可以在同一个页面创建多个 ng-app 节点(不推荐)
创建多个ng-app时,默认只能执行第一个,后面的需要手动引导:
angular.bootstrap() |
标记的范围尽可能小,性能,区域范围越小,性能会更好。
简单示例:
html结构举例:
<div ng-app='myApp'><!--这个div是程序的最外围DIV,标识着程序的入口> |
对应的javascript结构:
angular.module('myApp',[]); |
备注: 如果给ng-App 赋值如:ng-app='myApp',那么必须要在js中初始化,如: angular.module('myApp',[]) , 不然会报错。
ngController指令
用于将控制层的一个控制器作用到视图层,用于支持MVC开发模式的重要的一个方面。
必须在ngApp指令的范围之内
这条指令创造了一个新的作用域
这条指令,优先级很高。
简单举例:
html结构:
<div ng-app='myApp'> |
javascript结构:
angular.module('myApp',[]) |
ngBind指令
将作用域($scope)中的值绑定到元素的 innerHTML 上,其效果会比通过表达式绑定的方式更友好
用于改进表达式 {{}} 所带来的加载时表达式符号暂时性展现的问题。
简单举例:
html结构
<div ng-app='myApp'> <div ng-controller='myCtrl'> <span ng-bind='username'></span> </div> </div> |
javascript结构
angular.module('myApp',[]) |
ngBindHtml 指令
如果需要在页面上绑定 HTML 内容(比如标签的尖括号,不去转义)。
依赖 ngSanitize 服务,不在核心库中,需要单独引入库文件(angular-sanitize)。
简单示例:
html结构
<div ng-app='myApp'> |
javascript结构
angular.module('bindHtmlExample', ['ngSanitize']) |
ngRepeat 指令
ng-repeat 指令用来遍历一个数组重复创建当前元素
类似于模板引擎中的each
官方的例子涉及的东西很多
举个简单的实例:
html结构
<div ng-app='myApp'> |
javascript结构
angular.module('myApp',[]) }]); |
上面的 track by $index 是有意义的,因为ng-repeat不能遍历重复项,为了避免程序报错,我们加上 track by $index 可以在内部维护一个$index,就不会因为内容重复而报错。
ngClass 指令
ng-class用来给html动态设置css样式。
官网上的demo很不错
简单自己来写一写:
css结构
.red {color: red} html结构 <div ng-app='myApp'> |
javascript结构
var data = [ |
上面功能实现了输入对应的名字,显示红色
总结一下 ng-class的用法 : ng-class={} ,其实就是这样:ng-class={classname1:是否添加-boolean值,classname2:是否添加-boolean值}
另外 还有两个衍生的指令处理奇数和偶数行的样式指令: ngClassEven 和 ngClassOdd
ngCloak 指令
用于阻止html模板短暂性的展示,出现的用户体验问题
它会动态的在head里添加一段css样式
另外最重要的,angular库必须在head中引入!
官网上的demo,还解决了IE7css不兼容的问题。
下面简单写下小demo:
html结构
<!-- 在header里引入包 --> angular.module('myApp', []) |
上面的demo,如果不加ng-cloak指令,那么就会有html模板短暂性的呈现的这个bug,上面我们用了js来阻止了程序的运行,可以看到ng-cloak的作用。
ngShow和ngHide 指令
用于控制页面元素的隐藏和显示
值为boolean类型。
如果是false,就会在页面元素上加上一个类ng-hide用于隐藏元素
举个简单的例子:
html结构
<!--下面是关键代码,不需要javascript结构-->
点击隐藏右侧:<input type='checkbox'
ng-model='checked'>
<span ng-show='!checked'>控制隐藏显示</span>
可见 ngShow 和 ngHide都是一样的,我们可以通过取非的方式只用一个就可以了。
ngIf 指令
ngIf指令完全不同于ngShow或者ngHide ,它控制的是:是否有这个dom元素,而非显示隐藏。
举个小例子
关键代码:
Click: <input type='checkbox' ng-model='checked' ng-init='checked=true' /> |
ngSwitch 指令
根据表达式显示或隐藏对应的部分。
对应的子元素使用 ng-switch-when 指令,如果匹配选中选择显示,其他为匹配的则移除。
可以通过使用 ng-switch-default 指令设置默认选项,如果都没有匹配的情况,默认选项会显示。
on 属性必须和ng-switch一起使用,或者直接使用ng-switch属性。
此指令优先级很高
官网上的小demo分析
html结构
<div ng-app='myApp'> javascript结构 angular.module('myApp', []) |
上面用了ng-option的一个遍历循环。
在 ng-switch作用上的父盒子上动态的绑定了option里的值,只要选择有匹配那么在下面的子盒子就会相应的显示。其中可以使用on或者不使用on,但是ng-switch是必备的,直接用ng-switch='selection' 也可以。
ngHref 和 ngSrc 指令
ng-href / ng-src 指令用于解决当链接类型的数据绑定时造成的加载解析时的bug.因为我们的链接地址都是动态的,我们需要动态的绑定值到src或者href中,src或者href无法解析这样的形式 {{}} 所以就用 ng-src 和 ng-href来使用了。当然还有ng-srcset指令。
其他一些单向数据绑定的指令
ng-checked:单选/复选是否选中,只是单向绑定数据
ng-disabled:是否禁用
ng-readonly:是否只读
ng-selected:是否选中,只是单向绑定数据
事件指令
ng-change:发生改变
ng-copy:拷贝完成
ng-click:单击 ng-click='func()'
ng-dblclick:双击
ng-focus:得到焦点
ng-blur:失去焦点
ng-submit:表单提交
等等其他事件指令,这些事件指令,在事件触发时相应的完成我们赋予的功能。
自定义指令
指令无外乎增强了 HTML,提供额外的功能
以上的指令基本上已经可以满足我们的绝大多数需要了
少数情况下我们有一些特殊的需要,可以通过自定义指令的方式实现。
从更高的层次上说,指令是DOM元素上的一些标记(例如: 属性,元素名称,注释和一些CSS的类)用于转换DOM元素的内部或者对DOM元素进行一些行为上的绑定。
注意事项
自定义指令和自定义控制器都必须要挂载在模块之下。因为自定义指令的directive是angular.module下的一个方法,点击这里查看
具体用法为 angular.module('moduleName',[]).directive(name, directiveFactory);
angular.module 可以使用链式编程的形式,返回模块本身,可定义多个指令。
定义指令的时候用驼峰命名法如:myDirective , 使用的时候用匈牙利命名法:my-directive
自定义指令可以把一段重复使用的方法封装起来,类似封装一些组件来使用。
对return中的一些常用选项的说明
,官方文档的说明(访问不了,可能是因为文档上的路由设置,需要一层层的点进去查看),就不再举例了。
template : 用于将一段自定义的代码绑定到含有对应指令的html中。
templateUrl :
用于将’其他html’文件渲染进入含有对应指令的html中。当然这里的’其他html’里面可以有我们的指令或者表达式,其实就是代码段,和在当前页面一样使用,只是抽离出去了,方便管理。这里会用异步请求的方式来得到这个文件。注意:此处会发送一个xhr请求。
transclude :
值为布尔型,需要在template中添加一个内置指令ng-transclude,将含有这个自定义指令中的内容,放入到template中去渲染,然后放到含有自定义指令的DOM元素内。
replace : 值为布尔型, 开启后就会把含有自定义指令的DOM元素,替换成template中的内容。
scope :
规范指令的作用域的问题,如果没写,ng中默认的是放在根作用域中的,一般每个控制器就会有一个作用域,每个指令也会存在一个作用域,并且作用域存在继承关系,我们为了规范作用域,可以在自定义指令中有一个scope选项,在scope内部定义一些属性。下面是示例代码。
html结构:
<div ng-app='myApp'> javascript结构: angular.module('myApp',[]) |
代码输出 hello world 其中 @ 表示 scope中的属性值,引用了使用自定义指令的DOM元素的属性值。
restrict : 用于指定自定义指令的类型。 A,表示只匹配属性。E,表示只匹配元素。C,表示只匹配类名。AEC,表示三种都可以作为匹配项。而M,匹配注释指令,已经被高版本抛弃使用了,我们推荐使用A和E。
link函数 : angular 中允许在这个内部进行一些dom操作,格式是这样的: link:function(scope, element, attrs){} scope代表的是当前指令的作用域,element代表当前元素,attrs代表元素的属性,在里面用的是jqlite里面的api。备注,如果只去操作dom,那么我们只需要return一个函数就行了,不用 link选项了。