Vue.js 允许你注册自定义指令,这些指令提供了一种将行为附加到 DOM 元素上的方式,从而可以在元素上执行自定义的 DOM 操作。自定义指令非常有用,尤其是当你需要封装一些复杂的 DOM 操作逻辑时。
创建自定义指令
自定义指令通过 Vue 的 directives
选项来注册,或者在 Vue 应用外使用 Vue.directive()
方法全局注册。
局部注册
在 Vue 组件中,你可以在 directives
选项中注册一个局部自定义指令:
export default {
directives: {
focus: {
// 当被绑定的元素插入到 DOM 中时……
inserted: function (el) {
// 聚焦元素
el.focus();
}
}
}
}
全局注册
使用 Vue.directive()
方法可以全局注册一个自定义指令:
Vue.directive('focus', {
// 当被绑定的元素插入到 DOM 中时……
inserted: function (el) {
// 聚焦元素
el.focus();
}
})
钩子函数
一个指令定义对象可以提供几个钩子函数(均为可选):
bind
:只调用一次,指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。inserted
:被绑定元素插入父节点时调用(保证父节点存在,但不一定已被插入文档中)。update
:所在组件的 VNode 更新时调用,但是可能发生在其子 VNode 更新之前。指令的值可能发生了改变,也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新。componentUpdated
:指令所在组件的 VNode 及其子 VNode 全部更新后调用。unbind
:只调用一次,指令与元素解绑时调用。
使用自定义指令
在模板中,你可以这样使用上面定义的 focus
指令:
<input v-focus>
传递值给自定义指令
自定义指令还可以接收值,这些值在指令的钩子函数中作为参数传入:
Vue.directive('color-swatch', function (el, binding) {
el.style.backgroundColor = binding.value
})
在模板中使用时,可以这样传递值:
<span v-color-swatch="'#f00'">这里应该是红色</span>
或者,使用 JavaScript 表达式:
<span v-color-swatch="computedColor">这里应该是计算后的颜色</span>
通过上面的介绍,你应该能够创建和使用 Vue.js 的自定义指令了。自定义指令为 Vue 应用的开发提供了极大的灵活性和扩展性。