自定义指令

245 阅读3分钟

指令

指令:vue中指令就是标签v-开头的一种自定义的标签的属性,它在vue运行以后就具有封装好的功能,使用时就比较简洁。

v-后面的就是指令的名称,封装功能在directives中设置一个对象作为其属性,属性名就是指令的名称。指令名称后面的不加引号就是变量会取数据源中的数据作为参数传directives中设置的对象中的钩子函数,加引号就是字符串也会作为参数传给设置的对象中的钩子函数,指令函数能够接受所有合法的 JavaScript 表达式

指令对象的钩子函数

一个指令定义对象可以提供如下几个钩子函数 (均为可选):

bind:只调用一次,指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。

inserted:被绑定元素插入父节点时调用 (仅保证父节点存在,但不一定已被插入文档中)。

update:所在组件的模板结构重新渲染时调用,但是可能发生在其子 VNode 更新之前。指令的值可能发生了改变,也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新。

componentUpdated:指令所在组件的 VNode 及其子 VNode 全部更新后调用。

unbind:只调用一次,指令与元素解绑时调用。

ps:钩子函数中的this会指向window对象

钩子函数的参数

指令钩子函数会被传入以下参数:

  • el:指令所绑定的元素,可以用来直接操作 DOM。
  • binding:一个对象,包含以下 property:
    • name:指令名,不包括 v- 前缀。
    • value:指令的绑定值,例如:v-mydirective="1 + 1" 中,绑定值为 2。
    • oldValue:指令绑定的前一个值,仅在 update 和 componentUpdated 钩子中可用。无论值是否改变都可用。
    • expression:字符串形式的指令表达式。例如 v-mydirective="1 + 1" 中,表达式为 "1 + 1"。
    • arg:传给指令的参数,可选。例如 v-mydirective:foo 中,参数为 "foo"。
    • modifiers:一个包含修饰符的对象。例如:v-mydirective.foo.bar 中,修饰符对象为 { foo: true, bar: true }。
  • vnode:Vue 编译生成的虚拟节点。
  • oldVnode:上一个虚拟节点,仅在 update 和 componentUpdated 钩子中可用。

指令定义语法

局部指令

new Vue({
    directives:{指令名:{配置对象}}
})
// 配置对象中写自定义指令的钩子函数
new Vue({
    directives:{指令名:回调函数}
})
//直接写回调函数就是简写形式,回调函数在指令与元素成功绑定时会被调用,然后指令所在的模板被重新渲染时也会被调用。
指令的函数简写形式相当于写了bind和update两个钩子函数的功能

使用方法

<body>
    <div id="app">
        <h2 v-color="'blue'">{{msg}}</h2>
        <input type="text" v-model="info" v-autofocus v-color="'gold'">
    </div>
    <script>
        new Vue({
           el:"#app",
           data:{
            msg:"hello",
            info:"zhengxiuxi"
           },
           directives:{
            color:{
                inserted(el,obj){
                    console.log(el,obj);
                    el.style.color=obj.value;
                }
            },
            autofocus:{
                inserted(el){
                    el.focus();
                }
            }
           }
        });
        // 指令:vue中指令就是标签v-开头的一种自定义的标签的属性,它在vue运行以后就具有封装号的功能,使用时就比较简洁
    </script>

image.png

image.png

除了 el 之外,其它参数都应该是只读的,切勿进行修改。