Vue 中如何自定义指令？

推荐答案

在 Vue 中，自定义指令可以通过 Vue.directive 方法来实现。自定义指令可以用于直接操作 DOM 元素，常见的场景如表单自动聚焦、图片懒加载等。

// www.javascriptcn.com code example
// 全局自定义指令
Vue.directive('focus', {
  // 当绑定元素插入到 DOM 中时调用
  inserted: function (el) {
    el.focus(); // 聚焦元素
  }
});

// 在组件中使用
<template>
  <input v-focus />
</template>

本题详细解读

1. 自定义指令的基本结构

Vue 提供了 Vue.directive 方法来注册全局自定义指令。该方法接受两个参数：

• 指令名称（不带 v- 前缀）。
• 一个对象，包含指令的钩子函数。

Vue.directive('指令名称', {
  // 钩子函数
});

2. 常用的钩子函数

自定义指令可以定义多个钩子函数，常用的钩子函数包括：

• bind：只调用一次，指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。
• inserted：被绑定元素插入父节点时调用（仅保证父节点存在，但不一定已被插入文档中）。
• update：所在组件的 VNode 更新时调用，但可能发生在其子 VNode 更新之前。
• componentUpdated：指令所在组件的 VNode 及其子 VNode 全部更新后调用。
• unbind：只调用一次，指令与元素解绑时调用。

3. 钩子函数的参数

每个钩子函数都可以接收以下参数：

• el：指令所绑定的元素，可以用来直接操作 DOM。
• binding：一个对象，包含以下属性：
  • name：指令名，不包括 v- 前缀。
  • value：指令的绑定值，例如 v-my-directive="1 + 1" 中，绑定值为 2。
  • oldValue：指令绑定的前一个值，仅在 update 和 componentUpdated 钩子中可用。
  • expression：字符串形式的指令表达式，例如 v-my-directive="1 + 1" 中，表达式为 "1 + 1"。
  • arg：传给指令的参数，例如 v-my-directive:foo 中，参数为 "foo"。
  • modifiers：一个包含修饰符的对象，例如 v-my-directive.foo.bar 中，修饰符对象为 { foo: true, bar: true }。
• vnode：Vue 编译生成的虚拟节点。
• oldVnode：上一个虚拟节点，仅在 update 和 componentUpdated 钩子中可用。

4. 局部自定义指令

除了全局自定义指令，还可以在组件中定义局部指令：

// www.javascriptcn.com code example
export default {
  directives: {
    focus: {
      inserted: function (el) {
        el.focus();
      }
    }
  }
}

5. 使用场景

自定义指令通常用于需要对 DOM 元素进行底层操作的场景，例如：

• 自动聚焦输入框。
• 图片懒加载。
• 拖拽功能。
• 权限控制等。

通过自定义指令，开发者可以更灵活地操作 DOM，而不必依赖 jQuery 等库。