## 一、概述 除了核心功能默认内置的指令 (v-model 和 v-show)，Vue 也允许注册自定义指令。有的情况下，你仍然需要对普通 DOM 元素进行底层操作，这时候就会用到自定义指令。 自定义指令的用法跟内置指令一样，用在模板元素中； ``` <!-- 在模板元素中 --> <input v-focus> ``` >[danger] 自定义指令分全局指令和局部指令（仅注册的组件内可用）；全局指令用Vue.directive来定义，局部的是注册在组件的directives中； ## 二、简单示例 聚焦输入框的例子；  当页面加载时，该元素将获得焦点 (注意：`autofocus`在移动版 Safari 上不工作)。事实上，只要你在打开这个页面后还没点击过任何内容，这个输入框就应当还是处于聚焦状态。现在让我们用指令来实现这个功能： 1、用全局指令 ``` // 注册一个全局自定义指令 `v-focus` Vue.directive('focus', { // 当被绑定的元素插入到 DOM 中时…… inserted: function (el) { // 聚焦元素 el.focus() } }) ``` 然后你可以**在任何模板中任何元素上**使用新的`v-focus`属性，如下： ``` <input v-focus> ``` 2、如果想注册局部指令，组件中也接受一个`directives`的选项： ``` directives: { focus: { // 指令的定义 inserted: function (el) { el.focus() } } } ``` 然后你可以在**当前组件任何元素**上上使用新的`v-focus`属性，如下： ## 三、钩子函数 一个指令定义对象可以提供如下几个钩子函数 (均为可选)： * `bind`：只调用一次，指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。 * `inserted`：被绑定元素插入父节点时调用 (仅保证父节点存在，但不一定已被插入文档中)。 * `update`：所在组件的 VNode 更新时调用，**但是可能发生在其子 VNode 更新之前**。指令的值可能发生了改变，也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新。 * `componentUpdated`：指令所在组件的 VNode**及其子 VNode**全部更新后调用。 * `unbind`：只调用一次，指令与元素解绑时调用。 ## 四、钩子函数参数  ## 五、复杂的例子 ``` <div id="hook-arguments-example" v-demo:foo.a.b="message"></div> ``` ``` Vue.directive('demo', { bind: function (el, binding, vnode) { var s = JSON.stringify el.innerHTML = 'name: ' + s(binding.name) + '<br>' + 'value: ' + s(binding.value) + '<br>' + 'expression: ' + s(binding.expression) + '<br>' + 'argument: ' + s(binding.arg) + '<br>' + 'modifiers: ' + s(binding.modifiers) + '<br>' + 'vnode keys: ' + Object.keys(vnode).join(', ') } }) new Vue({ el: '#hook-arguments-example', data: { message: 'hello!' } }) ``` 运行结果如下：