在 Vue,除了核心功能默認(rèn)內(nèi)置的指令 ( v-model 和 v-show ),Vue 也允許注冊自定義指令。它的作用價值在于當(dāng)開發(fā)人員在某些場景下需要對普通 DOM 元素進(jìn)行操作。
Vue自定義指令有全局注冊和局部注冊兩種方式。先來看看注冊全局指令的方式,通過 Vue.directive( id, [definition] ) 方式注冊全局指令。然后在入口文件中進(jìn)行 Vue.use() 調(diào)用。
批量注冊指令,新建 directives/index.js 文件
import copy from './copy'
import longpress from './longpress'
// 自定義指令
const directives = {
copy,
longpress,
}
export default {
install(Vue) {
Object.keys(directives).forEach((key) => {
Vue.directive(key, directives[key])
})
},
}
在 main.js 引入并調(diào)用
import Vue from 'vue'
import Directives from './JS/directives'
Vue.use(Directives)
指令定義函數(shù)提供了幾個鉤子函數(shù)(可選):
bind: 只調(diào)用一次,指令第一次綁定到元素時調(diào)用,可以定義一個在綁定時執(zhí)行一次的初始化動作。
inserted: 被綁定元素插入父節(jié)點(diǎn)時調(diào)用(父節(jié)點(diǎn)存在即可調(diào)用,不必存在于 document 中)。
update: 被綁定元素所在的模板更新時調(diào)用,而不論綁定值是否變化。通過比較更新前后的綁定值。
componentUpdated: 被綁定元素所在模板完成一次更新周期時調(diào)用。
unbind: 只調(diào)用一次, 指令與元素解綁時調(diào)用。
下面分享幾個實(shí)用的 Vue 自定義指令
復(fù)制粘貼指令 v-copy
長按指令 v-longpress
輸入框防抖指令 v-debounce
禁止表情及特殊字符 v-emoji
圖片懶加載 v-LazyLoad
權(quán)限校驗(yàn)指令 v-premission
實(shí)現(xiàn)頁面水印 v-waterMarker
拖拽指令 v-draggable
v-copy
需求:實(shí)現(xiàn)一鍵復(fù)制文本內(nèi)容,用于鼠標(biāo)右鍵粘貼。
思路:
動態(tài)創(chuàng)建 textarea 標(biāo)簽,并設(shè)置 readOnly 屬性及移出可視區(qū)域
將要復(fù)制的值賦給 textarea 標(biāo)簽的 value 屬性,并插入到 body
選中值 textarea 并復(fù)制
將 body 中插入的 textarea 移除
在第一次調(diào)用時綁定事件,在解綁時移除事件
const copy = {
bind(el, { value }) {
el.$value = value
el.handler = () => {
if (!el.$value) {
// 值為空的時候,給出提示。可根據(jù)項(xiàng)目UI仔細(xì)設(shè)計(jì)
console.log('無復(fù)制內(nèi)容')
return
}
// 動態(tài)創(chuàng)建 textarea 標(biāo)簽
const textarea = document.createElement('textarea')
// 將該 textarea 設(shè)為 readonly 防止 iOS 下自動喚起鍵盤,同時將 textarea 移出可視區(qū)域
textarea.readOnly = 'readonly'
textarea.style.position = 'absolute'
textarea.style.left = '-9999px'
// 將要 copy 的值賦給 textarea 標(biāo)簽的 value 屬性
textarea.value = el.$value
// 將 textarea 插入到 body 中
document.body.appendChild(textarea)
// 選中值并復(fù)制
textarea.select()
const result = document.execCommand('Copy')
if (result) {
console.log('復(fù)制成功') // 可根據(jù)項(xiàng)目UI仔細(xì)設(shè)計(jì)
}
document.body.removeChild(textarea)
}
// 綁定點(diǎn)擊事件,就是所謂的一鍵 copy 啦
el.addEventListener('click', el.handler)
},
// 當(dāng)傳進(jìn)來的值更新的時候觸發(fā)
componentUpdated(el, { value }) {
el.$value = value
},
// 指令與元素解綁的時候,移除事件綁定
unbind(el) {
el.removeEventListener('click', el.handler)
},
}
export default copy
使用:給 Dom 加上 v-copy 及復(fù)制的文本即可
<template>
<button v-copy="copyText">復(fù)制</button>
</template>
<script> export default {
data() {
return {
copyText: 'a copy directives',
}
},
} </script>
剩余的請看原文
作者:MK麥客
鏈接:https://juejin.cn/post/7067051410671534116
來源:稀土掘金
著作權(quán)歸作者所有。商業(yè)轉(zhuǎn)載請聯(lián)系作者獲得授權(quán),非商業(yè)轉(zhuǎn)載請注明出處。