7.自定义指令

1.Vue有丰富的内置指令,在需要一些特殊功能时,我们仍希望对DOM进行底层的操作,这时就要用到自定义指令。
2.自定义指令的注册方法和组件很像,也分全局注册和局部注册,比如注册一个v-focus的指令,用于在<input>、<textarea>元素初始化时自动获得焦点,两种写法分别是:

    //全局注册
    Vue.directive('focus',{
        //指令选项
    })
    //局部注册
    var app = new Vue({
        el:'#app',
        directives:{
            focus:{
                //指令选项
            }
        }
    })

写法与组件基本类似,只是方法名由component改为了directive。
上例只是注册了自定义指令v-focus,还没有实现具体功能。
3.自定义指令的各个选项都是由几个钩子函数组成的,每个都是可选的。

  • bind:只调用一次,指令第一次绑定到元素时调用,用这个钩子函数可以定义一个绑定时执行一次的初始化动作。
  • inserted:被绑定元素插入父节点时调用(父节点存在即可调用,不必存在于document中)
  • update:被绑定元素所在的模板更新时调用,而不论绑定值是否变化。通过比较更新前后的绑定值,可以忽略不必要的模板更新。
  • componentUpdated:被绑定元素所在模板完成一次更新周期时调用。
  • unbind:只调用一次,指令与元素解绑时调用。

4.可以根据需求在不同的钩子函数内完成逻辑代码,例如上面的v-focus,我们希望在元素插入父节点时就调用,那用到的最好是inserted。示例:

<div id="app">
    <input type="text" v-focus>
</div>
<script>
    //全局注册
    Vue.directive('focus',{
        //指令选项
        inserted:function(el){
            //聚焦元素
            el.focus();
        }
    })
    //局部注册
    var app = new Vue({
        el:'#app'
    })
</script>

可以看到,打开这个页面,input输入框就自动获得了焦点,成为可输入状态。
5.每个钩子函数都有几个参数可用,比如上面我们用到了el。它们的含义如下:

  • el 指令所绑定的元素,可以用来直接操作DOM。
  • binding 一个对象,包含以下属性:

    name :指令名,不包括 v-前缀。
    value :指令的绑定值,例如 v-my-directive="1+1" ,value的值是2。
    oldValue :指令绑定的前一个值,仅在update 和 componentUpdated 钩子中可用。无论值是否改变都可用。
    expression :绑定至的字符串形式。例如 v-my-directive="1+1",expredsion的值是 "1+1"。
    arg:传给指令的参数。例如 v-my-directive:foo,arg的值是foo。
    modifiers :一个包含修饰符的对象。例如 v-my-directive.foo.bar,修饰符对象modifiers的值是{ foo:true , bar: true}。
    vnode :Vue编译生成的虚拟节点,后续介绍。
    oldVnode :上一个虚拟节点仅在update 和 componentUpdate钩子中可用。
    下面是结合了以上参数的一个示例:

<div id="app">
    <div v-test:msg.a.b="message"></div>
</div>
<script>
    Vue.directive('test',{
        bind:function(el,binding,vnode){
            var keys = [];
            for(var i in vnode){
                keys.push(i)
            }
            el.innerHTML = 
                'name:' + binding.name + '<br>' +
                'value:' + binding.value + '<br>' +
                'expression:' + binding.expression + '<br>' + 
                'argument:' + binding.arg + '<br>' +
                'modifiers:' + JSON.stringify(binding.modifiers) + '<br>' +
                'vnode keys:' + keys.join(',')
        }
    });
    //局部注册
    var app = new Vue({
        el:'#app',
        data:{
            message:'some text'
        }
    })
</script>

在大多数使用场景,我们会在 bind 钩子里绑定一些事件,比如在document上用 addEventListener绑定,在unbind里用 removeEventListener 解绑,比较典型的示例就是让这个元素随着鼠标拖拽。如果需要多个值,自定义指令可以传入一个JavaScript对象字面量,只要是合法类型的JavaScript表达式都是可以的。示例:

<div id="app">
    <div v-test="{msg:'hello',name:'Aresn'}"></div>
</div>
<script>
    Vue.directive('test',{
        bind:function(el,binding,vnode){
            console.log(binding.value.msg)
            console.log(binding.value.name)
        }
    });
    //局部注册
    var app = new Vue({
        el:'#app'
    })
</script>

Vue2.x移除了大量Vue 1.x自定义指令的配置。
在使用自定义指令时,应该充分理解业务需求,因为很多时候你需要的可能并不是自定义指令,而是组件。后续的实战示例可以进一步了解自定义指令的使用场景和用法。

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