vue 自定义指令directives及其常用钩子函数说明

自定义指令directives及常用钩子函数

说明

除了核心功能默认内置的指令 (v-model 和 v-show)，Vue 也允许注册自定义指令

使用的地方：有的情况下，你仍然需要对普通 DOM 元素进行底层操作，这时候就会用到自定义指令

钩子函数

• inserted：被绑定元素插入父节点时调用 (仅保证父节点存在，但不一定已被插入文档中)。
• bind：只调用一次，指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。
• update: 所在组件的 VNode 更新时调用，但是可能发生在其子 VNode 更新之前。指令的值可能发生了改变，也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新。
• componentUpdated：指令所在组件的 VNode 及其子 VNode 全部更新后调用。
• unbind：只调用一次，指令与元素解绑时调用。

vue 全局定义

使用：<span v-指令名称> welcome </span> 也可以 v-指令名称="传递的参数"

定义：Vue.directive(指令名称，{指令钩子：功能函数})

<div id="root">
        <span v-red>welcome</span>
    </div>
    <script type="text/javascript">
        Vue.directive('red',{       //定义 ???
            inserted:function(el){  //钩子函数 ???
                el.style.background = 'red';
            }
        });
        var vm = new Vue({
               el:"#root"
            data:{            
            },
        })
    </script>

局部定义（vue-cli）

使用：<div v-指令名称='传递的参数'></div> // 传递参数可以根据功能需求进行操作

定义：directives{指令名称:{钩子函数:功能函数}}

<template>
  <div class="hello">
      <div v-test='name'></div>
  </div>
</template>
<script>

export default {
  data () {
    return {
     name:'userName',
    }
  },
  directives:{     //自定义指令 ???
      test:{
        inserted: function (el,binding) { //e为绑定元素，可以对其进行dom操作
           console.log(binding)          //一个对象，包含很多属性属性(在下面)
        },
        bind: function (el, binding, vnode) {
            el.innerHTML =binding.value
          }
      }
  },
  methods:{
     ... ...
  }
}
</script>

钩子函数里面的参数

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

name：指令名，不包括 v- 前缀。

value：指令的绑定值，例如：v-my-directive=“1 + 1” 中，绑定值为 2。

oldValue：指令绑定的前一个值，仅在 update 和 componentUpdated 钩子中可用。无论值是否改变都可用。

expression：字符串形式的指令表达式。例如 v-my-directive=“1 + 1” 中，表达式为 “1 + 1”。

arg：传给指令的参数，可选。例如 v-my-directive:foo 中，参数为 “foo”。

modifiers：一个包含修饰符的对象。例如：v-my-directive.foo.bar 中，修饰符对象为 { foo: true, bar: true }。

• vnode：Vue 编译生成的虚拟节点。
• oldVnode：上一个虚拟节点，仅在 update 和 componentUpdated 钩子中可用。

vue 自定义指令 directives选项

directives选项中定义 指令

使用时添加v-前缀

全局注册

app.directive('xxx',{})

支持动态指令参数

v-xx:[abc]='xxx'

指令函数能够接受所有合法的 JavaScript 表达式。

如果方法只需要在 mounted 和 updated 的时间钩子触发

可以简写为单纯的回调函数

参数说明

第一个参数 为绑定的元素

第二个参数 为传递的对象

• .arg 绑定的参数
• .value 等号后对应的值

在应用到组件上时，和非 prop 的 attribute不同，指令不会通过 v-bind="$attrs" 被传入另一个元素。

当被应用在一个多根节点的组件上时，指令会被忽略，并且会抛出一个警告。