写点什么

Vue 自定义指令

  • 2023-06-09
    北京
  • 本文字数:2258 字

    阅读完需:约 7 分钟

自定义指令

vue 里面不仅仅有内置的指令,也可以根据自己的需求构建自定义指令


它其实就是操作 DOM 元素的属性以及内容


通过 directives 属性配置自定义指令,有函数式和对象式两种写法,下面分别去写下

1 函数式

通过案例去实现自定义函数式指令


需求:定义一个 v-big 指令,和 v-text 功能类似,但是会把绑定的数值放大十倍



控制台报错,说解析指令失败



接下来就要定义指令了,需要一个全新的配置项:directives,它的值也是一个对象,和 computed,watch 是类似的写法


函数式写法如下,有两个参数 参数 1 是绑定元素,参数 2 是绑定对象



元素和绑定对象内容如下



接下来就可以使用 dom 操作改变元素了



查看页面,功能实现



那么这个函数什么时候会被调用呢?


有两个时机会被调用:1:指令与元素成功绑定时(初始化),会被调用 2:指令所在的模板被重新解析的时候


代码如下


<!DOCTYPE html><html>
<head> <meta charset="UTF-8"> <title>初始vue</title> <!-- 引入vue.js --> <script type="text/javascript" src="../js/vue.js"></script></head><body> <div id="root"> <h2>当前n的值是:<span v-text="n"></span></h2> <h2>放大10倍后的n值是:<span v-big="n"></span></h2> <button @click="n++">点我n+1</button> </div></body>
<script type="text/javascript"> const vm= new Vue({ el:'#root', data:{ n:1, }, // 自定义指令 directives:{ // 函数式 有两个参数 参数1是绑定元素,参数2是绑定对象 // 有两个时机会被调用:1:指令与元素成功绑定时(初始化),会被调用 2:指令所在的模板被重新解析的时候 big(element,binging){ element.innerText=binging.value*10 } }
})
</script>
</html>
复制代码

2 对象式

对象式写起来比函数式复杂,但是功能比函数式更强大


它有三个不同的函数,在不同的时刻去被调用


bind:指令与元素成功绑定时(一上来)调用


inserted:指令所在元素被插入页面的时候调用


update:指令所在的模板被重新解析时调用


通过案例去实现自定义对象式指令


需求:定义一个 v-fbind 指令,和 v-bind 功能类似,但是可以让其绑定的 input 默认获取焦点



一上来肯定找不到指令,因为既不是内置的,也没有自定义



使用对象式编写代码



一上就来获取焦点



并且会随着 n 的值变化而变化



代码如下


<!DOCTYPE html><html>
<head> <meta charset="UTF-8"> <title>初始vue</title> <!-- 引入vue.js --> <script type="text/javascript" src="../js/vue.js"></script></head><body> <div id="root"> <h2>当前n的值是:<span v-text="n"></span></h2> <h2>放大10倍后的n值是:<span v-big="n"></span></h2> <button @click="n++">点我n+1</button> <hr/> <input type="text" v-fbind:value="n" > </div></body>
<script type="text/javascript"> const vm= new Vue({ el:'#root', data:{ n:1, }, // 自定义指令 directives:{ // 函数式 有两个参数 参数1是绑定元素,参数2是绑定对象 // 有两个时机会被调用:1:指令与元素成功绑定时(初始化),会被调用 2:指令所在的模板被重新解析的时候 big(element,binging){ element.innerText=binging.value*10 }, // 对象式 fbind:{ // 指令与元素成功绑定时(一上来) bind(element,binging){ element.value=binging.value }, // 指令所在元素被插入页面的时候调用 inserted(element,binging){ // 获取焦点 element.focus() }, // 指令所在的模板被重新解析时 update(element,binging){ element.value=binging.value }, } }
})
</script>
</html>
复制代码

3 自定义指令容易踩的坑

1 多个单词的指令名

现在我的两个自定义指令都是一个单词的,v-big,v-fbind,如果需要用到多个单词,比如 v-binNum,这时候使用驼峰就不好使了



可以看到,找不到这个指令



这不是官网推荐的风格,多个单词应该-继续分割,比如 v-big-num,此时在函数编写的地方需要使用原生的形式,使用单引号把 key 包起来,不能再用简写形式了,不然出现-(杠)会报错



解决


2 指令回调函数的 this

所有被 vue 管理的函数,里面的 this 都是 vm 实例对象


现在把回调函数里面的 this 都输出下



发现 this 都是全局的 window,而不是 vue 实例



虽然没写剪头函数,但是只要是指令 directives 里面的 this,都不是 vue 实例,就是 window

4 自定义指令总结

  • 1 定义语法

  • (1)局部指令

  • new Vue({direvtives:{指令名:配置对象}})或 new Vue({direvtives()})

  • (2)全局指令

  • Vue.directive(指令名,配置对象)或 Vue.directive(指令名,回调函数)


  • 2 配置对象中常用的三个回调

  • (1) bind:指令与元素成功绑定时(一上来)调用

  • (2) inserted:指令所在元素被插入页面的时候调用

  • (3) update:指令所在的模板被重新解析时调用


  • 3 备注:

  • (1):指令定义时不加 v-,但是使用时需要加 v-

  • (2) :指令名如果是多个单词,要使用 kebab-case 命令方式,不要使用 camelCase 命名

发布于: 刚刚阅读数: 3
用户头像

还未添加个人签名 2022-10-26 加入

还未添加个人简介

评论

发布
暂无评论
Vue自定义指令_6 月优质更文活动_我搬去水星了_InfoQ写作社区