AngularJS自定义指令

使用.directive()方法来注册一个新指令
传入两个参数,第一个参数传入一个字符串,作为指令的名字;第二个参数是一个函数,该函数返回一个对象,返回的对象中包含了用来定义和配置指令所需的方法和属性。

基本使用

创建一个自定义元素my-directive

// index.html
<my-directive></my-directive>

// app.js
var app = angular.module('myApp', []);
app.directive('myDirective', function() {
    return {
        restrict: 'E',
        template: '<dir>Nari</dir>'
    };
});

创建的指令在html文件中不仅可以用作元素,还可以作为属性,类或者注释使用

<my-directive></my-directive>
<div my-directive></div>
<div class="my-directive"></div>
<!--directive:my-directive-->

restrict设置以哪种方式调用:元素(E) 、属性(A) 、类(C)、注释(M)

向指令传递数据 scope: {}

template可接受变量的形式:template: '<dir>{{ varName }}</dir>'
在html文件中,可以给指令添加var-name属性,该参数会成为指令内部作用域的属性

双向绑定的问题:如果是在事件处理函数(event handler)中改变了绑定model,需要手动触发digest,因为这是发生在angular范围之外,所以scope无法知道model的变化,如下:

element.on('click', function() {
$scope.modal = newModal;
$scope.$apply();
})

// index.html
<div my-directive var-name="Nari"></div>

// app.js
app.directive('myDirective', function() {
    return {
        restrict: 'A',
        replace: true,
        // 使用隔离作用域,创建指令自己的$scope属性
        scope: {    
            varName: '@',
            varName: '=',
            varName: '&'
        },
        template: '<dir>{{ varName }}</dir>'
    };
});

绑定策略
'@': 表示AngularJS将DOM中var-name属性的值复制给新作用域对象中的varName属性,var-name属性改变,作用域对象中的varName属性会自动更新
'=': 表示在指令的作用域和其他model作用域建立了一个双向数据绑定
'&': 表示在指令的作用域和其他model作用域进行绑定,调用其函数

绑定函数的传参方式有两种:

// 第一种:指令中调用函数时传入一个对象,对象的属性名是html中对应的参数名
// index.html
<div my-directive callback-fun="doSomething(argName)"></div>

// app.js
app.directive('myDirective', function() {
    return {
        restrict: 'A',
        scope: { 
            callbackFun: '&'
        },
        link: function(scope, ele, attrs) {
            // 传入一个对象
            scope.callbackFun({argName: value})
        }
    };
});

// 第二种:html中指定函数名,在指令中调用函数时传参
// index.html
<div my-directive callback-fun="doSomething"></div>

// app.js
app.directive('myDirective', function() {
    return {
        restrict: 'A',
        scope: { 
            callbackFun: '&'
        },
        link: function(scope, ele, attrs) {
            // scope.callbackFun()相当于获取该函数引用,然后正常调用函数
            scope.callbackFun()(arg1, arg2, ...)
        }
    };
});
模板 template templateUrl

定义指令模板,
template指定模板HTML字符串
templateUrl可以指定模板路径或者一个函数,函数可以接受两个参数tElement和tAttrs,并返回一个代表模板的字符串

引入外部指令 require

查找该值对应的指令,将查找到的指令的控制器注入到当前指令中
寻找策略:
策略——寻找指令名称,如果没有找到,link函数第4个参数为null;如果没有?,则报错。
**^ **策略——在自身指令寻找指令名称的同时,向上父元素寻找;如果没有^,则仅在自身寻找。

指令控制器 controller controllerAs

可定义一个匿名函数或传入一个控制器名
指令的控制器和link函数可以进行互换。控制器主要是用来提供可在指令间复用的行为,但link函数只能在当前内部指令中定义行为,且无法在指令间复用。

controller: function($scope, $element, $attrs){
    // 可以注入一些服务,$scope就是当前作用域,$element当前指令对应的元素,$attrs当前元素的属性组成的对象
}
优先级控制 terminal

可以被设置为true或false,设为true时会使AngularJS停止运行当前元素上比本指令优先级低的指令。但同当前指令优先级相同的指令还是会被执行

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,924评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,902评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,716评论 0 239
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,783评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,166评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,510评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,784评论 2 311
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,476评论 0 196
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,196评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,459评论 2 243
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,978评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,321评论 2 252
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,964评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,046评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,803评论 0 193
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,530评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,420评论 2 265

推荐阅读更多精彩内容