AngularJS内置指令
2015-10-30 17:24
597 查看
这篇文章通篇都是转的...原文出处无从考究,转载的网站本身就没有标明原文出处,SO,这里也没必要帮它做宣传了。
指令,我将其理解为 AngularJS 操作 HTML element 的一种途径。
由于学习 AngularJS 的第一步就是写内置指令 ng-app 以指出该节点是应用的根节点,所以指令早已不陌生。
这篇日志简单记录了一些内置指令,先使用起来,再谈一些有趣的东西。
内置指令
所有的内置指令的前缀都为 ng,不建议自定义指令使用该前缀,以免冲突。
首先从一些常见的内置指令开始。
先列出一些关键的内置指令,顺便简单说说作用域的问题。
ng-model
将表单控件和当前作用域的属性进行绑定,这么解释似乎也不太正确。
但先不要管咬文嚼字,用起来倒是易懂,例如:
代码如下:
ng-init
该指令被调用时会初始化内部作用域。
这个指令一般会出现在比较小的应用中,比如给个 demo 什么的...
代码如下:
ng-app
每一次用 AngularJS 都离不开这个指令,顺便说下 $rootScope。
声明了 ng-app 的元素会成为 $rootScope 的起点,而 $rootScope 是作用域链的根,通常声明在 <html> 你懂的。
也就是说根下的作用域都可以访问它。
但是,不建议过度使用 $rootScope,免得全局变量满天飞,效率又差又难管。
下面是一个例子:
代码如下:
ng-controller
我们用这个指令在一个 DOM 元素上装上 controller。
一个控制器? 确实,从字面意思上这样理解倒是不错,那我们为什么需要控制器?
记得 AngularJS 1.2.x 时还可以这样定义 controller 来着...
代码如下:
AngularJS 1.3.x 中禁止了这种方式,因为这种方式会让 controller 满天飞,分不清层次,所有东西都挂在 $rootScope 上...
ng-controller 必须有一个表达式作为参数,另外通过 $scope 来继承上级 $scope 的方法和属性什么的,$rootScope 也包括在内。
下面只是一个简单的例子,ancestor 无法访问 child 的作用域。
代码如下:
ng-form
起初不明白为什么会有个表单指令,<form> 标签感觉也够用啊。
以表单验证为例,在上一篇中有这么一段代码:
代码如下:
也就是表单的状态为 $invalid 时禁用提交按钮。
如果场景再稍微复杂一点点,比如一个父表单中有多个子表单,子表单中有3个验证通过时父表单便可以提交。
但是,<form> 是不可以嵌套的。
考虑到这种场景,我们便使用 ng-form 指令来解决这一问题。
例如:
代码如下:
ng-disabled
像这种只要出现则生效的属性,我们可以在 AngularJS 中通过表达式返回值 true/false 令其生效。
禁用表单输入字段。
代码如下:
ng-readonly
通过表达式返回值 true/false 将表单输入字段设为只读。
代码如下:
ng-checked
这个是给 <input type="checkbox" /> 用的,比如...
代码如下:
ng-selected
给 <select> 里面的 <option> 用的,例子:
代码如下:
ng-show/ng-hide
根据表达式显示/隐藏 HTML 元素,注意是隐藏,不是从 DOM 移除,例如:
代码如下:
ng-change
不是 HTML 那套 onXXX 之类的,而是 ng-XXX。
结合 ng-model 使用,以 ng-change 为例:
代码如下:
ng-options 也就是 {{}}
其实这个也是一个指令,也许觉得和 ng-bind 差不多,但页面渲染略慢时可能会被看到。
另外,{{}} 的 performance 远不如 ng-bind,只是用起来很方便。
ng-bind
ng-bind 的行为和 {{}} 差不多,只是我们可以用这个指令来避免页面编译生成过程产生的页面闪烁,也就是未渲染导致的闪烁。
ng-cloak
ng-cloak 可以为我们解决页面闪烁问题。 ng-cloak 会将内部未解析的元素隐藏,直到路由调用对应的页面并编译解析完成后才显示。
ng-if
如果 ng-if 中的表达式为 false,则对应的元素整个会从 DOM 中移除而非隐藏,但审查元素时你可以看到表达式变成注释了。
如果相进行隐藏,可以使用 ng-hide。
代码如下:
ng-switch
单独使用没什么意思,下面是例子:
代码如下:
ng-repeat
不明白为毛不叫 iterate,总之是遍历集合,给每个元素生成模板实例,每个实例的作用域中可以用一些特殊属性,如下:
$index
$first
$last
$middle
even
odd
不用特地解释,这些都很容易看出来是干什么的,下面是一个例子:
代码如下:
ng-href
起初我在一个文本域中弄了个 ng-model,然后像这样 <a href="{{myUrl}}"> 在 href 里面写了进去。
其实这样 href 和 ng-href 看不出什么区别,所以我们可以试试这样:
代码如下:
ng-src
大同小异,即表达式生效前不要加载该资源。
代码如下:
ng-class
用作用域中的对象动态改变类样式,例如:
代码如下:
指令,我将其理解为 AngularJS 操作 HTML element 的一种途径。
由于学习 AngularJS 的第一步就是写内置指令 ng-app 以指出该节点是应用的根节点,所以指令早已不陌生。
这篇日志简单记录了一些内置指令,先使用起来,再谈一些有趣的东西。
内置指令
所有的内置指令的前缀都为 ng,不建议自定义指令使用该前缀,以免冲突。
首先从一些常见的内置指令开始。
先列出一些关键的内置指令,顺便简单说说作用域的问题。
ng-model
将表单控件和当前作用域的属性进行绑定,这么解释似乎也不太正确。
但先不要管咬文嚼字,用起来倒是易懂,例如:
代码如下:
<input type="text" ng-model="someModel.someProperty" /> <br> {{someModel.someProperty}}
ng-init
该指令被调用时会初始化内部作用域。
这个指令一般会出现在比较小的应用中,比如给个 demo 什么的...
代码如下:
<div ng-init="job='fighter'"> I'm a/an {{job}} </div>
ng-app
每一次用 AngularJS 都离不开这个指令,顺便说下 $rootScope。
声明了 ng-app 的元素会成为 $rootScope 的起点,而 $rootScope 是作用域链的根,通常声明在 <html> 你懂的。
也就是说根下的作用域都可以访问它。
但是,不建议过度使用 $rootScope,免得全局变量满天飞,效率又差又难管。
下面是一个例子:
代码如下:
<html ng-app="myApp"> <body> {{ someProperty }} </body> <script> var myApp = angular.module('myApp', []) .run(function($rootScope) { $rootScope.someProperty = 'hello computer'; }); </script> </html>
ng-controller
我们用这个指令在一个 DOM 元素上装上 controller。
一个控制器? 确实,从字面意思上这样理解倒是不错,那我们为什么需要控制器?
记得 AngularJS 1.2.x 时还可以这样定义 controller 来着...
代码如下:
function ohMyController($scope) { //... }
AngularJS 1.3.x 中禁止了这种方式,因为这种方式会让 controller 满天飞,分不清层次,所有东西都挂在 $rootScope 上...
ng-controller 必须有一个表达式作为参数,另外通过 $scope 来继承上级 $scope 的方法和属性什么的,$rootScope 也包括在内。
下面只是一个简单的例子,ancestor 无法访问 child 的作用域。
代码如下:
<div ng-controller="AncestorController"> {{ ancestorName }} {{ childName }} <div ng-controller="ChildController"> {{ ancestorName }} {{ childName }} </div> </div> <script> var myApp = angular.module('myApp', []) .controller('ChildController', function($scope) { $scope.childName = 'child'; }) .controller('AncestorController', function($scope) { $scope.ancestorName = 'ancestor'; }); </script>
ng-form
起初不明白为什么会有个表单指令,<form> 标签感觉也够用啊。
以表单验证为例,在上一篇中有这么一段代码:
代码如下:
<input type="submit" ng-disabled="mainForm.$invalid" />
也就是表单的状态为 $invalid 时禁用提交按钮。
如果场景再稍微复杂一点点,比如一个父表单中有多个子表单,子表单中有3个验证通过时父表单便可以提交。
但是,<form> 是不可以嵌套的。
考虑到这种场景,我们便使用 ng-form 指令来解决这一问题。
例如:
代码如下:
<form name="mainForm" novalidate> <div ng-form="form1"> 姓名:<input type="text" ng-required="true" ng-model="name"/><br> 证件号码:<input type="number" ng-minLength="15" ng-maxLength="18" ng-required="true" ng-model="idnum"/> </div> <br> <div ng-form="form2"> 监护人姓名:<input type="text" ng-required="true" ng-model="gname"/><br> 监护人证件号码:<input type="number" ng-minLength="15" ng-maxLength="18" ng-required="true" ng-model="gidnum"/> </div> <button ng-disabled="form1.$invalid && form2.$invalid">submit all</button> </form>
ng-disabled
像这种只要出现则生效的属性,我们可以在 AngularJS 中通过表达式返回值 true/false 令其生效。
禁用表单输入字段。
代码如下:
<textarea ng-disabled="1+1==2">1+1=?</textarea>
ng-readonly
通过表达式返回值 true/false 将表单输入字段设为只读。
代码如下:
<input type="text" ng-readonly="1+1==2" value="stop the world after 3s"/>
ng-checked
这个是给 <input type="checkbox" /> 用的,比如...
代码如下:
<input type="checkbox" ng-checked="someProperty" ng-init="someProperty = true" ng-model="someProperty">
ng-selected
给 <select> 里面的 <option> 用的,例子:
代码如下:
<label> <input type="checkbox" ng-model="isFullStack"> I'm Full Stack Engineer </label> <select> <option>Front-End</option> <option>Back-End</option> <option ng-selected="isFullStack">Full Stack !!!</option> </select>
ng-show/ng-hide
根据表达式显示/隐藏 HTML 元素,注意是隐藏,不是从 DOM 移除,例如:
代码如下:
<div ng-show="1+1 == 2"> 1+1=2 </div> <div ng-hide="1+1 == 3"> you can't see me. </div>
ng-change
不是 HTML 那套 onXXX 之类的,而是 ng-XXX。
结合 ng-model 使用,以 ng-change 为例:
代码如下:
<input type="text" ng-model="calc.arg" ng-change="calc.result = calc.arg*2" /> <code>{{ calc.result }}</code>
ng-options 也就是 {{}}
其实这个也是一个指令,也许觉得和 ng-bind 差不多,但页面渲染略慢时可能会被看到。
另外,{{}} 的 performance 远不如 ng-bind,只是用起来很方便。
ng-bind
ng-bind 的行为和 {{}} 差不多,只是我们可以用这个指令来避免页面编译生成过程产生的页面闪烁,也就是未渲染导致的闪烁。
ng-cloak
ng-cloak 可以为我们解决页面闪烁问题。 ng-cloak 会将内部未解析的元素隐藏,直到路由调用对应的页面并编译解析完成后才显示。
ng-if
如果 ng-if 中的表达式为 false,则对应的元素整个会从 DOM 中移除而非隐藏,但审查元素时你可以看到表达式变成注释了。
如果相进行隐藏,可以使用 ng-hide。
代码如下:
<div ng-if="1+1===3"> 无法审查到该元素 </div> <div ng-hide="1+1==2"> 可审查 </div>
ng-switch
单独使用没什么意思,下面是例子:
代码如下:
<div ng-switch on="1+1"> <p ng-switch-default>0</p> <p ng-switch-when="1">1</p> <p ng-switch-when="2">2</p> <p ng-switch-when="3">3</p> </div>
ng-repeat
不明白为毛不叫 iterate,总之是遍历集合,给每个元素生成模板实例,每个实例的作用域中可以用一些特殊属性,如下:
$index
$first
$last
$middle
even
odd
不用特地解释,这些都很容易看出来是干什么的,下面是一个例子:
代码如下:
<ul> <li ng-repeat="char in [{'alphabet': 'K'}, {'alphabet': 'A'}, {'alphabet': 'V'}, {'alphabet': 'L'}, {'alphabet': 'E'}, {'alphabet': 'Z'}] " ng-show="$even">{{char.alphabet}}</li> </ul>
ng-href
起初我在一个文本域中弄了个 ng-model,然后像这样 <a href="{{myUrl}}"> 在 href 里面写了进去。
其实这样 href 和 ng-href 看不出什么区别,所以我们可以试试这样:
代码如下:
<ul ng-init="myHref=''"> <li><a ng-href="{{ myHref }}">{{linkText}}</a></li> <li><a href="{{ myHref }}">可以点击,但不一定是正确的地址</a></li> </ul> app.run(function ($rootScope, $timeout) { $rootScope.linkText = '尚未加载,您无法点击'; $timeout(function () { $rootScope.linkText = '请点击'; $rootScope.myHref = 'http://google.com'; }, 2000); })
ng-src
大同小异,即表达式生效前不要加载该资源。
代码如下:
<img ng-src="{{imgSrc}}"/> app.run(function ($rootScope, $timeout) { $timeout(function () { $rootScope.imgSrc = 'https://octodex.github.com/images/daftpunktocat-guy.gif'; }, 2000); })
ng-class
用作用域中的对象动态改变类样式,例如:
代码如下:
<style> .red {background-color: red;} .blue {background-color: blue;} </style> <div ng-controller="CurTimeController"> <button ng-click="getCurrentSecond()" >Get Time!</button> <p ng-class="{red: x%2==0,blue: x%2!=0}" >Number is: {{ x }}</p> </div> app.controller('CurTimeController', ['$scope', function ($scope) { $scope.getCurrentSecond = function() { $scope.x = new Date().getSeconds(); }; }])
相关文章推荐
- angularjs依赖服务注入写法的注意点
- angularjs 绑定enter事件的两种方法
- AngularJS中如何绑定html内容
- AngularJS: 'Template for directive must have exactly one root element' when using 'th' tag in directive template
- angularJs-HelloWorld
- angular 版本区间
- AngularJS开发下一代Web应用笔记(一)
- AngularJs angular.identity和angular.noop
- AngularJs angular.equals
- angular $q服务
- angularjs知识点
- angular在ie9中button表现失常的问题
- AngularJS使用OData请求ASP.NET Web API资源的思路
- angularjs与PHP的交互通信问题
- AngularJs angular.element
- 读angularjs权威指南入坑之旅
- Angularjs Response Headers 只有content-type
- angularjs现在真的那么少?
- AngularJS之Provider, Value, Constant, Service, Factory, Decorator的区别与详解
- angular模块加载