除了 Vue 内置的一系列指令 (比如 v-model
或 v-show
) 之外,Vue 还允许你注册自定义的指令 (Custom Directives)。
一个自定义指令由一个包含类似组件生命周期钩子的对象来定义。钩子函数会接收到指令所绑定元素作为其参数。
数字化管理平台
Vue3+Vite+VueRouter+Pinia+Axios+ElementPlus
Vue权限系统案例
个人博客地址
在 中,任何以
v
开头的驼峰式命名的变量都可以被用作一个自定义指令。在下面的例子中,vFocus
即可以在模板中以 v-focus
的形式使用。
当一个 input 元素被 Vue 插入到 DOM 中后,它会被自动聚焦
{{ message }}
控制台打印参数:
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-kzi2DlUm-1685599646057)(Vue3课程笔记导读.assets/Vue指令生命周期.png)]
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-2zIIHErd-1685599646058)(Vue3课程笔记导读.assets/image-20221230173216123.png)]
注:自定义指令属于破坏性更新。
将一个自定义指令全局注册到应用层级也是一种常见的做法,这样的话在任何一个组件中都可以调用此全局指令。
如下,在 main.js 中定义一个全局指令:
// 导入 createApp 方法:每个 Vue 应用都是通过 createApp 函数创建一个新的应用实例:
import { createApp } from 'vue'
// 导入根组件
import App from './App.vue'
// 通过 createApp() 函数创建一个新的应用实例
// 我们传入 createApp 的对象实际上是一个组件,每个应用都需要一个“根组件”,其他组件将作为其子组件。
const app = createApp(App)
// 注册全局指令
app.directive('focus',{
mounted: (el) => el.focus()
})
// 挂载应用:应用实例必须在调用了 .mount() 方法后才会渲染出来。该方法接收一个“容器”参数,可以是一个实际的 DOM 元素或是一个 CSS 选择器字符串
// .mount() 方法应该始终在整个应用配置和资源注册完成后被调用。同时请注意,不同于其他资源注册方法,它的返回值是根组件实例而非应用实例。
app.mount('#app')
在任意组件内调用上面注册的全局指令 v-focus
页面效果
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-hK0BYRxl-1685599646058)(Vue3课程笔记导读.assets/image-20221230170208984.png)]
一个指令的定义对象可以提供几种钩子函数 (都是可选的):
const myDirective = {
// 在绑定元素的 attribute 前
// 或事件监听器应用前调用
created(el, binding, vnode, prevVnode) {
// 下面会介绍各个参数的细节
},
// 在元素被插入到 DOM 前调用
beforeMount(el, binding, vnode, prevVnode) {},
// 在绑定元素的父组件
// 及他自己的所有子节点都挂载完成后调用
mounted(el, binding, vnode, prevVnode) {},
// 绑定元素的父组件更新前调用
beforeUpdate(el, binding, vnode, prevVnode) {},
// 在绑定元素的父组件
// 及他自己的所有子节点都更新后调用
updated(el, binding, vnode, prevVnode) {},
// 绑定元素的父组件卸载前调用
beforeUnmount(el, binding, vnode, prevVnode) {},
// 绑定元素的父组件卸载后调用
unmounted(el, binding, vnode, prevVnode) {}
}
指令的钩子会传递以下几种参数:
el
:指令绑定到的元素。这可以用于直接操作 DOM。binding
:一个对象,包含以下属性。
value
:传递给指令的值。例如在 v-my-directive="1 + 1"
中,值是 2
。oldValue
:之前的值,仅在 beforeUpdate
和 updated
中可用。无论值是否更改,它都可用。arg
:传递给指令的参数 (如果有的话)。例如在 v-my-directive:foo
中,参数是 "foo"
。modifiers
:一个包含修饰符的对象 (如果有的话)。例如在 v-my-directive.foo.bar
中,修饰符对象是 { foo: true, bar: true }
。instance
:使用该指令的组件实例。dir
:指令的定义对象。vnode
:代表绑定元素的底层 VNode。prevNode
:之前的渲染中代表指令所绑定元素的 VNode。仅在 beforeUpdate
和 updated
钩子中可用。前后端所有鉴权方案