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=&ldquo;1 + 1&rdquo; 中，绑定值为 2。

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

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

arg：传给指令的参数，可选。例如 v-my-directive:foo 中，参数为 &ldquo;foo&rdquo;。

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" 被传入另一个元素。

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

来源：https://blog.csdn.net/qq_44163269/article/details/107508091