Vue 自定義指令可以直接操作 DOM，適合封裝那些需要直接訪問 DOM 元素的邏輯。比如自動聚焦、許可權控制、圖片懶載入等。

指令的生命週期鉤子

Vue.directive("my-directive", {
  bind(el, binding, vnode) {
    // 指令繫結到元素時呼叫（只調用一次）
    // 此時元素可能還沒插入 DOM
  },
  inserted(el, binding, vnode) {
    // 元素插入父 DOM 後呼叫
    // 可以操作 DOM，父元素已存在
  },
  update(el, binding, vnode, oldVnode) {
    // 元件 VNode 更新時呼叫
    // 注意：子元件可能還沒更新
  },
  componentUpdated(el, binding, vnode, oldVnode) {
    // 元件和子元件 VNode 都更新後呼叫
  },
  unbind(el, binding, vnode) {
    // 指令從元素解綁時呼叫（只調用一次）
    // 清理工作在這裡做
  },
});

binding 物件包含：

• binding.value：指令的值（v-my-dir="value" 裡的 value）
• binding.arg：指令的引數（v-my-dir:arg）
• binding.modifiers：修飾符物件（v-my-dir.modifier）

實戰 1：自動聚焦

Vue.directive("focus", {
  inserted(el) {
    el.focus();
  },
});

<el-input v-focus placeholder="搜尋" />

實戰 2：許可權控制

根據使用者許可權決定是否渲染元素：

// src/directives/permission.js
import store from "@/store";

export default {
  inserted(el, binding) {
    const required = binding.value; // 需要的許可權，如 'admin' 或 ['admin', 'editor']
    const userPerms = store.getters.permissions;

    const requiredList = Array.isArray(required) ? required : [required];
    const hasPermission = requiredList.some((perm) => userPerms.includes(perm));

    if (!hasPermission) {
      el.parentNode?.removeChild(el); // 直接從 DOM 移除
    }
  },
};

// 全域性註冊
import permissionDirective from "./directives/permission";
Vue.directive("permission", permissionDirective);

<template>
  <div>
    <!-- 只有 admin 能看到 -->
    <el-button v-permission="'admin'" type="danger">刪除</el-button>

    <!-- admin 或 editor 都能看到 -->
    <el-button v-permission="['admin', 'editor']">編輯</el-button>
  </div>
</template>

實戰 3：圖片懶載入

Vue.directive("lazyload", {
  inserted(el, binding) {
    const src = binding.value;

    // 用 IntersectionObserver 檢測元素是否在視口內
    const observer = new IntersectionObserver(
      (entries) => {
        entries.forEach((entry) => {
          if (entry.isIntersecting) {
            el.src = src;
            observer.unobserve(el); // 載入後取消觀察
          }
        });
      },
      {
        threshold: 0.1, // 元素出現 10% 時觸發
      },
    );

    observer.observe(el);
    el._observer = observer; // 儲存引用，用於 unbind 清理
  },
  unbind(el) {
    el._observer?.disconnect();
  },
});

<img
  v-lazyload="'https://example.com/large-image.jpg'"
  src="/placeholder.png"
/>

實戰 4：防重複點選

防止按鈕連續點選提交多次請求：

Vue.directive("throttle", {
  bind(el, binding) {
    const delay = binding.value || 1000;
    let lastTime = 0;

    el._throttleHandler = function (event) {
      const now = Date.now();
      if (now - lastTime < delay) {
        event.stopImmediatePropagation(); // 阻止後續事件處理
        return;
      }
      lastTime = now;
    };

    el.addEventListener("click", el._throttleHandler, true); // 捕獲階段
  },
  unbind(el) {
    el.removeEventListener("click", el._throttleHandler, true);
  },
});

<el-button v-throttle="2000" @click="handleSubmit">提交</el-button>

實戰 5：點選外部關閉

彈出層、下拉選單常見需求：

Vue.directive("click-outside", {
  bind(el, binding) {
    el._clickOutsideHandler = function (event) {
      if (!el.contains(event.target)) {
        binding.value(event); // 呼叫傳入的函式
      }
    };
    document.addEventListener("click", el._clickOutsideHandler);
  },
  unbind(el) {
    document.removeEventListener("click", el._clickOutsideHandler);
  },
});

<div v-click-outside="closeDropdown" class="dropdown">
  <!-- 下拉內容 -->
</div>

區域性註冊

不必全域性註冊，可以在元件內註冊：

export default {
  directives: {
    focus: {
      inserted(el) {
        el.focus();
      },
    },
  },
};

小結

自定義指令適合直接操作 DOM 的邏輯，不適合業務邏輯。

• 記得在 unbind 裡清理事件監聽器、IntersectionObserver 等資源
• 優先考慮用元件或 mixin 實現功能，指令是補充手段
• 好用的指令：許可權控制、懶載入、防重複點選、點選外部關閉