自定义指令定义和使用
学习：app.directive()、directives 选项
当一个 input 元素被 Vue 插入到 DOM 中后，它会被自动聚焦：
完整案例：10_directive/01_directive.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>自定义指令</title> </head> <body> <div id="app"> <input type="text" v-focus> <div v-red>使用指令变字体为红色</div> <!-- 加引号的原因是 不要把green作为变量 --> <div v-color="'green'">使用指令变字体为参数绿色</div> <input type="text" v-model="tel" v-phone v-focus> {{ tel }} </div> </body> <script src="../lib/vue.global.js"></script> <script> const app = Vue.createApp({ data () { return { tel: '123' } }, directives: { red: { mounted (el) { el.style.color = 'red' } }, color: { // mounted (el, params) { // console.log(params) // el.style.color = params.value // } mounted (el, { value }) { console.log(value) el.style.color = value } }, phone: { // dom操作可在 mounted 以及 updated中使用 mounted (el) { if (/^1[3-9]\d{9}$/.test(el.value)) { el.style.color = 'green' } else { el.style.color = 'red' } }, updated (el) { // 只要数据更新，updated就会触发 if (/^1[3-9]\d{9}$/.test(el.value)) { el.style.color = 'green' } else { el.style.color = 'red' } } } } }) // 全局自定义指令 app.directive('focus', { mounted (el) { // el 就是当前指令对应的DOM节点 el.focus() } }) app.mount('#app') </script> </html>
自定义指令钩子
一个指令的定义对象可以提供几种钩子函数 (都是可选的)：
vue3相比 vue2，钩子函数做了更新
vue2中一个指令定义对象可以提供如下几个钩子函数 (均为可选)：
bind：只调用一次，指令第一次绑定到元素时调用。在这里可以进行一次性的初始化设置。inserted：被绑定元素插入父节点时调用 (仅保证父节点存在，但不一定已被插入文档中)。update：所在组件的 VNode 更新时调用，但是可能发生在其子 VNode 更新之前。指令的值可能发生了改变，也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新 (详细的钩子函数参数见下)。componentUpdated：指令所在组件的 VNode 及其子 VNode 全部更新后调用。unbind：只调用一次，指令与元素解绑时调用。
// vue3钩子函数 const myDirective = { // 在绑定元素的 attribute 前 // 或事件监听器应用前调用 created(el, binding, vnode, prevVnode) { // 下面会介绍各个参数的细节 }, // 在元素被插入到 DOM 前调用 beforeMount(el, binding, vnode, prevVnode) {}, // 在绑定元素的父组件 // 及他自己的所有子节点都挂载完成后调用 mounted(el, binding, vnode, prevVnode) {}, // 绑定元素的父组件更新前调用 beforeUpdate(el, binding, vnode, prevVnode) {}, // 在绑定元素的父组件 // 及他自己的所有子节点都更新后调用 updated(el, binding, vnode, prevVnode) {}, // 绑定元素的父组件卸载前调用 beforeUnmount(el, binding, vnode, prevVnode) {}, // 绑定元素的父组件卸载后调用 unmounted(el, binding, vnode, prevVnode) {} }
指令的钩子会传递以下几种参数：
el：指令绑定到的元素。这可以用于直接操作 DOM。binding：一个对象，包含以下属性。
value：传递给指令的值。例如在v-my-directive="1 + 1"中，值是2。oldValue：之前的值，仅在beforeUpdate和updated中可用。无论值是否更改，它都可用。arg：传递给指令的参数 (如果有的话)。例如在v-my-directive:foo中，参数是"foo"。modifiers：一个包含修饰符的对象 (如果有的话)。例如在v-my-directive.foo.bar中，修饰符对象是{ foo: true, bar: true }。instance：使用该指令的组件实例。dir：指令的定义对象。
vnode：代表绑定元素的底层 VNode。prevNode：之前的渲染中代表指令所绑定元素的 VNode。仅在beforeUpdate和updated钩子中可用。
