angular directive

directive 是 angular 中最重要的一部分,也是最难的部分。Angular 内部封装了一些指令,例如 ng-model ng-class ng-click。Angular 内部指令大部分都是以 ng 开头的。

directive 匹配方式

按照 Angular 的标准,指令的命名规则是以驼峰式命名的(例如ngModel)。然而,由于 HTML 是不区分大小写的,因此通常用一个 DOM 元素的划线分隔属性(例如ng-model)。

Angular 匹配指令过程如下:
1、去除元素或属性的前缀 data-x-
2、将 : _ - 连接字符串转换成驼峰表现形式

因此通常在使用中可以写成以下几种形式:

ng-model
ng:model
ng_model
data-ng-model
x-ng-model

directive 种类

$compile可以基于标签、属性、类名 、注释匹配 directive。

<my-directive></my-directibe> // 元素
<div my-directive='exp'></div> // 属性
<div class='my-directive'></div> // 类名
<!-- directive:my-directive exp --> // 注释

建议更多的使用标签和属性类型的指令。

创建自定义 directive

指令注册的方式与 controller 一样,但是它返回的是一个拥有指令配置属性的简单对象(指令定义对象) 。
下面的代码是一个简单的 myDirective 指令。

var app = angular.module('directive', []);

app.directive('myDirective', function() {
  return {
    template: '<div></div>',
    restrict: 'E',
    link: function postLink(scope, element, attrs) {
      element.text('my directive!!');
    }
  }
})

这个指令在 HTML 中以一个元素使用,如下
其中 templaterestrictlink 都是指令配置属性,还有其他的属性,我们对其逐一的解释,属性名称下的第一行分别是属性名称、属性类型、默认值。

  • multiElement
    多元素、booleanfalse
    当此属性设置为 true 时,HTML 编译器将收集在 directive-name-startdirective-name-end 两个属性之间的 DOM 节点,并将它们组一起作为指令元素。
    建议将此功能应用于行为不严格的指令(如 ngclick),和
    不处理或更换子节点(如 nginclude)。
  • priority
    优先级、number0
    当有多个 directive 定义在同一个 DOM 元素上时,有时需要明确他们的执行顺序。
    这个属性用于在 directive 的 compile 方法调用之前进行排序。
    值越大越先编译。
    如果优先级相同,则执行顺序是不确定的。
  • terminal
    终点、booleanfalse
    如果设置为 true,则表示当前的 priority 将会成为最后一组执行的 directive,即比此 directive 的 priority 更低的 directive 将不会执行。同优先级依然会执行,但是顺序不确定。
  • scope
    两种值:
  • true
    将为这个 directive 创建一个新的 scope 。
    如果在同一个元素中有多个 directive 需要新的 scope 的话,它还是只会创建一个scope。新的 scope 规则不适用于根模版,因为根模版往往会获得一个新的scope。
  • {}
    将创建一个新的、独立的 scope ,此 scope 与一般的 scope 的区别在于——它不是通过原型继承于父scope的。
    这对于创建可复用的组件是很有帮助的,可以有效的防止读取或者修改父级 scope 的数据。这个独立的 scope 会创建一个拥有一组来源于父 scope 的本地 scope 属性 hash 集合。这些本地 scope 属性对于模版创建值的别名很有帮助。本地的定义是对其来源的一组本地 scope property 的 hash 映射。
  • controller
    controller构造函数。controller 会在 pre-linking 步骤之前进行初始化,并允许其他 directive 通过指定名称的 require 进行共享。这将允许 directive 之间相互沟通,增强相互之间的行为。controller默认注入了以下本地对象:
  • $scope - 与当前元素结合的 scope
  • $element - 当前的元素
  • $attrs - 当前元素的属性对象
  • $transclude - 一个预先绑定到当前 scope 的转置linking function。(A transclude linking function pre-bound to the correct transclusion scope)
  • require
    请求另外的 controller ,传入当前 directive 的 linking function中。require 需要传入一个 directive controller 的名称。如果找不到这个名称对应的 controller ,那么将会抛出一个 error 。
    名称可以加入以下前缀:
  • ? 不要抛出异常。这将使得这个依赖变为一个可选项
  • ^ 允许查找父元素的controller
  • restrict
    EACM 的子集的字符串,它限制了 directive 为指定的声明方式。如果省略的话,directive 将仅仅允许通过属性声明
  • E 元素名称:<my-directive></my-directive>
  • A 属性名: <div my-directive="exp"></div>
  • C 类名: <div class="my-directive : exp"></div>
  • M 注释:``
  • transclude
  • compile
  • link
  • template
    如果 replace 为 true ,则将模版内容替换当前的 html 元素,并将原来元素的属性、class一并转移;
    如果 replace 为 false,则将模版元素当作当前元素的子元素处理。
  • templateUrl
    与 template 基本一致,但模版通过指定的url进行加载。因为模版加载是异步的,所有 compilation、linking 都会暂停,等待加载完毕后再执行。
  • replace
    如果设置为 true ,那么模版将会替换当前元素,而不是作为子元素添加到当前元素中。(为 true 时,模版必须有一个根节点
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,271评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,275评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,151评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,550评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,553评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,559评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,924评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,580评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,826评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,578评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,661评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,363评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,940评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,926评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,156评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,872评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,391评论 2 342

推荐阅读更多精彩内容