1. 自定义指令概述

1.1 核心概念

概念	描述
指令	带有 v- 前缀的特殊属性
钩子函数	指令的生命周期函数
指令参数	指令的修饰符和值

1.2 指令生命周期

---

2. 自定义指令基础

2.1 指令注册

// 全局注册
Vue.directive('focus', {
  inserted: function (el) {
    el.focus()
  }
})

// 局部注册
const vm = new Vue({
  directives: {
    focus: {
      inserted: function (el) {
        el.focus()
      }
    }
  }
})

2.2 指令使用

<input v-focus>

---

3. 指令钩子函数详解

3.1 钩子函数参数

参数	描述
el	指令绑定的元素
binding	包含指令信息的对象
vnode	Vue 编译生成的虚拟节点
oldVnode	上一个虚拟节点

3.2 钩子函数示例

Vue.directive('demo', {
  bind: function (el, binding, vnode) {
    console.log('bind')
  },
  inserted: function (el, binding, vnode) {
    console.log('inserted')
  },
  update: function (el, binding, vnode, oldVnode) {
    console.log('update')
  },
  componentUpdated: function (el, binding, vnode, oldVnode) {
    console.log('componentUpdated')
  },
  unbind: function (el, binding, vnode) {
    console.log('unbind')
  }
})

---

4. 自定义指令应用场景

4.1 表单自动聚焦

Vue.directive('focus', {
  inserted: function (el) {
    el.focus()
  }
})

4.2 权限控制

Vue.directive('permission', {
  inserted: function (el, binding) {
    const { value } = binding
    const permissions = ['admin', 'editor']
    if (!permissions.includes(value)) {
      el.parentNode && el.parentNode.removeChild(el)
    }
  }
})

4.3 图片懒加载

Vue.directive('lazy', {
  inserted: function (el, binding) {
    const observer = new IntersectionObserver((entries) => {
      entries.forEach(entry => {
        if (entry.isIntersecting) {
          el.src = binding.value
          observer.unobserve(el)
        }
      })
    })
    observer.observe(el)
  }
})

---

5. 高级应用技巧

5.1 动态指令参数

Vue.directive('pin', {
  bind: function (el, binding) {
    el.style.position = 'fixed'
    const s = binding.arg || 'top'
    el.style[s] = binding.value + 'px'
  }
})

5.2 指令修饰符

Vue.directive('on', {
  bind: function (el, binding) {
    const { value, modifiers } = binding
    const event = Object.keys(modifiers)[0] || 'click'
    el.addEventListener(event, value)
  },
  unbind: function (el, binding) {
    const { value, modifiers } = binding
    const event = Object.keys(modifiers)[0] || 'click'
    el.removeEventListener(event, value)
  }
})

5.3 指令组合

Vue.directive('tooltip', {
  bind: function (el, binding) {
    const tooltip = document.createElement('div')
    tooltip.className = 'tooltip'
    tooltip.innerHTML = binding.value
    el.appendChild(tooltip)
    
    el.addEventListener('mouseenter', () => {
      tooltip.style.display = 'block'
    })
    el.addEventListener('mouseleave', () => {
      tooltip.style.display = 'none'
    })
  },
  unbind: function (el) {
    const tooltip = el.querySelector('.tooltip')
    tooltip && el.removeChild(tooltip)
  }
})

---

6. 性能优化与调试

6.1 性能优化策略

1. 减少 DOM 操作：使用虚拟 DOM
2. 合理使用钩子函数：避免不必要的更新
3. 指令复用：提取公共逻辑

6.2 调试技巧

1. 控制台日志：在钩子函数中添加日志
2. Vue Devtools：查看指令绑定状态
3. 性能分析：使用 Chrome DevTools

---

7. 最佳实践建议

7.1 命名规范

1. 语义化命名：体现指令功能
2. 前缀约定：如 v-auth- 表示权限相关
3. 避免冲突：确保全局唯一性

7.2 代码组织

src/
├── directives/
│   ├── focus.js
│   ├── permission.js
│   └── lazy.js
└── main.js

---

8. 常见问题与解决方案

8.1 问题列表

问题	原因	解决方案
指令不生效	未正确注册	检查注册方式
性能问题	频繁 DOM 操作	优化指令逻辑
样式冲突	全局样式影响	使用 scoped 样式

8.2 调试技巧

1. Chrome DevTools：
   • 检查元素绑定
   • 监控事件监听
2. Vue Devtools：
   • 查看指令状态
   • 跟踪指令更新

---

9. 扩展阅读

• Vue 官方文档 - 自定义指令
• Vue 源码解析 - 指令系统
• 前端性能优化指南

---

通过本文的深度解析，开发者可以全面掌握 Vue 自定义指令的使用方法与最佳实践。建议结合实际项目需求，合理使用自定义指令，以提升代码复用性和开发效率。