自定义指令(1)

一、介绍

我们之前用到的ng-click、ng-class、ng-show等都是angular的内置指令,我们也可以自定义指令。自定义指令的基本结构如下:

var myApp=angular.module('myApp',[])
.directive('myDirective',function(){ //以下都已myDirective名字为例
    return {
        //在此具体定义指令
    }
});

通过directive方法进行自定义指令,函数返回一个对象,对象中通过设置属性、方法对指令进行具体的定义,下面来介绍一些简单的设置

二、简单自定义指令
1、restrict

restrict共有四个值,分别是E、C、M、A

  • E:代表元素element
  • C:代表类 class
  • A:代表属性attribute
  • M:代表注释
    我们可以设置为:
    restrict:'ECA' //这局是设置在上例return返回的对象中的
    这句话的意思是如果html中有一个有一个元素是myDirective,或者class中有myDirective、属性名是myDirective都会执行这个自定义指令
    这里要特别说明一下html中的使用:在js中自定义指令时用驼峰法命名,使用时必须分隔符‘-’进行连接,
    如:
<my-directive>这里是自定义的指令</my-directive>      //对应E
<div class="my-directive">这里是自定义的指令</div>   //对应C
<div my-directive>这里是自定义的指令</div>           //对应A
2、template/templateUrl

看名字就知道这里是一个模板,其实就是一个html代码片段,当遇到自定义指令时我们以什么样的内容来展示这个指令:
template:'<div>哈哈哈,测试,这是一个自定义指令</div>'
如果这个模板的内容比较复杂一些,html内容比较多,我们就可以将它单独放到一个html文件中,用templateUrl属性,值为这个html文件的路径
templateUrl:'template.html' //假设template中的内容也为<div>哈哈哈,测试,这是一个自定义指令</div>
假如这个时候我们只设置了restrict、template/templateUrl两个属性,那么html中的
<my-directive>这里是自定义的指令</my-directive> 最后会成为
<my-directive><div>哈哈哈,测试,这是一个自定义指令</div></my-directive>
此处仅以element为例,class、attribute同理。
我们可以看到html中原来的“这里是自定义的指令”内容没有了

3、transclude

上面我们看到html中原来的内容消失了,利用transclude可以将原先的内容添加的模板中,如:

        template:'<div>哈哈哈,测试,这是一个自定义指令<br/><div ng-transclude></div></div>',
        transclude:true   //默认为false

请注意上面代码的第一行中模板内容有一个带有ng-transclude指令的元素,原来的内容就会被放入这个元素内

4、replace

我们的指令"my-directive"在html中并不符合html规范,而且这也并不是我们想要的内容,我们仅需要模板中的内容,所以可以用replace:true将其去掉,

//自定义指令
        return{
            restrict:'ECAM',
            template:'<div>哈哈哈,测试,replace为true</div>',
            replace:true
        }
    <test-replace>element</test-replace>
    <div class="test-replace">class</div>
    <div test-replace>attribute</div>
最终显示结果

浏览器解析结果

我们可以看到原始html中指令结构没有了,模板内容取代了这个结构,但是restrict为E、C时会在模板的最外层加上对应的class或属性
当replace时,模板中必须要有一个最外层的元素包裹着内容,否则会报错

三、总结
  • 驼峰命名法,注意在html中调用时要用test-no-replace,分隔符“-”必须要有,否则 E、A解析不出来
  • 没有replace或者false,模板的内容会嵌入到标签内,替换原来标签的内容
  • replace为true,模板的内容会替换此标签,同时当为C、A时会给模板添加对应的class、attribute
  • 当replace为true时,模板中的内容必须包含在一个标签中,例如:如果直接是一个字符串“angular"就会报错
  • transclude包含标签原有的数据,将原有的数据嵌入到ng-transclude标签中
    自己动手实践去看看具体的显示结果
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,904评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,581评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,527评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,463评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,546评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,572评论 1 293
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,582评论 3 414
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,330评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,776评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,087评论 2 330
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,257评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,923评论 5 338
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,571评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,192评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,436评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,145评论 2 366
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,127评论 2 352

推荐阅读更多精彩内容