下面是对变更的简要总结:
v-bind="$attrs"
更多信息,请继续阅读!
在 Vue 2,自定义指令是通过使用下面列出的钩子来创建的,这些钩子都是可选的
下面是一个例子:
<p v-highlight="yellow">高亮显示此文本亮黄色</p>
Vue.directive('highlight', {
bind(el, binding, vnode) {
el.style.background = binding.value
}
})
在这里,在这个元素的初始设置中,指令通过传递一个值来绑定样式,该值可以通过应用程序更新为不同的值。
然而,在 Vue 3 中,我们为自定义指令创建了一个更具凝聚力的 API。正如你所看到的,它们与我们的组件生命周期方法有很大的不同,即使我们正与类似的事件钩子,我们现在把它们统一起来了:
updated
。最终 API 如下:
const MyDirective = {
beforeMount(el, binding, vnode, prevVnode) {},
mounted() {},
beforeUpdate() {},
updated() {},
beforeUnmount() {}, // 新
unmounted() {}
}
生成的 API 可以这样使用,与前面的示例相同:
<p v-highlight="yellow">高亮显示此文本亮黄色</p>
const app = Vue.createApp({})
app.directive('highlight', {
beforeMount(el, binding, vnode) {
el.style.background = binding.value
}
})
既然定制指令生命周期钩子映射了组件本身的那些,那么它们就更容易推理和记住了!
通常建议保持指令独立于它们所使用的组件实例。从自定义指令中访问实例通常表明该指令本身应该是一个组件。然而,在某些情况下,这实际上是有意义的。
在Vue 2中,必须通过vnode
参数访问组件实例:
bind(el, binding, vnode) {
const vm = vnode.context
}
在Vue 3中,实例现在是bind
的一部分:
mounted(el, binding, vnode) {
const vm = binding.instance
}
在 Vue 3 中,我们现在支持片段,这允许我们为每个组件返回多个 DOM 节点。你可以想象,对于具有多个 <li>
的组件或一个表的子元素这样的组件有多方便:
<template>
<li>Hello</li>
<li>Vue</li>
<li>Devs!</li>
</template>
如此灵活,我们可能会遇到一个定制指令的问题,它可能有多个根节点。
因此,自定义指令现在作为虚拟 DOM 节点数据的一部分包含在内。当在组件上使用自定义指令时,钩子作为无关的 prop 传递到组件,并以 this.$attrs
结束。
这也意味着可以像这样在模板中直接挂接到元素的生命周期中,这在涉及到自定义指令时非常方便:
<div @vnodeMounted="myHook" />
这与属性 fallthrough 行为是一致的,因此,当子组件在内部元素上使用 v-bind="$attrs"
时,它也将应用对其使用的任何自定义指令。