小白教程
所有教程
关于
Search
172.69.58.95
172.69.58.95
参数设置
贡献
退出
操作
编辑
移动
保护
信息
历史
删除
查看“Vue3 自定义指令”的源代码
本页内容
上一节:
Vue3_表单
下一节:
Vue3_路由
因为以下原因,您没有权限编辑本页:
您请求的操作仅限属于该用户组的用户执行:
用户
您可以查看和复制此页面的源代码。
{{DISPLAYTITLE:Vue3 自定义指令}}[[Category:Vue 3 教程|16]] = Vue3 自定义指令 = 除了默认设置的核心指令( v-model 和 v-show ), Vue 也允许注册自定义指令。 下面我们注册一个全局指令 v-focus, 该指令的功能是在页面加载时,元素获得焦点: <sample title="" desc="" lang="html" hererun="1"> <div id="app"> <p>页面载入时,input 元素自动获取焦点:</p> <input v-focus> </div> <script> const app = Vue.createApp({}) // 注册一个全局自定义指令 `v-focus` app.directive('focus', { // 当被绑定的元素挂载到 DOM 中时…… mounted(el) { // 聚焦元素 el.focus() } }) app.mount('#app') </script> </sample> <run name=""> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Vue 测试实例 - 小白教程(xiaobai.wang)</title> <script src="https://unpkg.com/vue@next"></script> </head> <body> <div id="app"> <p>页面载入时,input 元素自动获取焦点:</p> <input v-focus> </div> <script> const app = Vue.createApp({}) // 注册一个全局自定义指令 `v-focus` app.directive('focus', { // 当被绑定的元素挂载到 DOM 中时…… mounted(el) { // 聚焦元素 el.focus() } }) app.mount('#app') </script> </body> </html> </run> 我们也可以在实例使用 directives 选项来注册局部指令,这样指令只能在这个实例中使用: <sample title="" desc="" lang="html" hererun="1"> <div id="app"> <p>页面载入时,input 元素自动获取焦点:</p> <input v-focus> </div> <script> const app = { data() { return { } }, directives: { focus: { // 指令的定义 mounted(el) { el.focus() } } } } Vue.createApp(app).mount('#app') </sample> <run name=""> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Vue 测试实例 - 小白教程(xiaobai.wang)</title> <script src="https://unpkg.com/vue@next"></script> </head> <body> <div id="app"> <p>页面载入时,input 元素自动获取焦点:</p> <input v-focus> </div> <script> const app = { data() { return { } }, directives: { focus: { // 指令的定义 mounted(el) { el.focus() } } } } Vue.createApp(app).mount('#app') </script> </body> </html> </run> == 钩子 == === 钩子函数 === 指令定义函数提供了几个钩子函数(可选): * <code>created </code>: 在绑定元素的属性或事件监听器被应用之前调用。 * <code>beforeMount </code>: 指令第一次绑定到元素并且在挂载父组件之前调用。。 * <code>mounted </code>: 在绑定元素的父组件被挂载后调用。。 * <code>beforeUpdate</code>: 在更新包含组件的 VNode 之前调用。。 * <code>updated</code>: 在包含组件的 VNode 及其子组件的 VNode 更新后调用。 * <code>beforeUnmount</code>: 当指令与在绑定元素父组件卸载之前时,只调用一次。 * <code>unmounted</code>: 当指令与元素解除绑定且父组件已卸载时,只调用一次。 <sample title="" desc="" lang="html" hererun="1"> import { createApp } from 'vue' const app = createApp({}) // 注册 app.directive('my-directive', { // 指令是具有一组生命周期的钩子: // 在绑定元素的 attribute 或事件监听器被应用之前调用 created() {}, // 在绑定元素的父组件挂载之前调用 beforeMount() {}, // 绑定元素的父组件被挂载时调用 mounted() {}, // 在包含组件的 VNode 更新之前调用 beforeUpdate() {}, // 在包含组件的 VNode 及其子组件的 VNode 更新之后调用 updated() {}, // 在绑定元素的父组件卸载之前调用 beforeUnmount() {}, // 卸载绑定元素的父组件时调用 unmounted() {} }) // 注册 (功能指令) app.directive('my-directive', () => { // 这将被作为 `mounted` 和 `updated` 调用 }) // getter, 如果已注册,则返回指令定义 const myDirective = app.directive('my-directive') </sample> === 钩子函数参数 === 钩子函数的参数有: '''el''' el 指令绑定到的元素。这可用于直接操作 DOM。 '''binding''' binding 是一个对象,包含以下属性: * <code>instance</code>:使用指令的组件实例。 * <code>value</code>:传递给指令的值。例如,在 <code>v-my-directive="1 + 1"</code> 中,该值为 <code>2</code>。 * <code>oldValue</code>:先前的值,仅在 <code>beforeUpdate</code> 和 <code>updated</code> 中可用。值是否已更改都可用。 * <code>arg</code>:参数传递给指令 (如果有)。例如在 <code>v-my-directive:foo</code> 中,arg 为 <code>"foo"</code>。 * <code>modifiers</code>:包含修饰符 (如果有) 的对象。例如在 <code>v-my-directive.foo.bar</code> 中,修饰符对象为 <code>{foo: true,bar: true}</code>。 * <code>dir</code>:一个对象,在注册指令时作为参数传递。例如,在以下指令中: <pre>app.directive('focus', { mounted(el) { el.focus() } })</pre> dir 将会是以下对象: <pre>{ mounted(el) { el.focus() } }</pre> '''vnode''' 作为 el 参数收到的真实 DOM 元素的蓝图。 '''prevNode''' 上一个虚拟节点,仅在 beforeUpdate 和 updated 钩子中可用。 以下实例演示了这些参数的使用: <sample title="" desc="" lang="html" hererun="1"> <div id="app"> <div v-xiaobai="{ name: '小白教程', url: 'www.xiaobai.wang' }"></div> </div> <script> const app = Vue.createApp({}) app.directive('xiaobai', (el, binding, vnode) => { console.log(binding.value.name) // => "小白教程" console.log(binding.value.url) // => "www.xiaobai.wang" var s = JSON.stringify el.innerHTML = s(binding.value) }) app.mount('#app') </script> </sample> <run name=""> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Vue 测试实例 - 小白教程(xiaobai.wang)</title> <script src="https://cdn.staticfile.org/vue/3.2.31/vue.global.min.js"></script> </head> <body> <div id="app"> <div v-xiaobai="{ name: '小白教程', url: 'www.xiaobai.wang' }"></div> </div> <script> const app = Vue.createApp({}) app.directive('xiaobai', (el, binding, vnode) => { console.log(binding.value.name) // => "小白教程" console.log(binding.value.url) // => "www.xiaobai.wang" var s = JSON.stringify el.innerHTML = s(binding.value) }) app.mount('#app') </script> </body> </html> </run> 有时候我们不需要其他钩子函数,我们可以简写函数,如下格式: <pre> Vue.directive('xiaobai', function (el, binding) { // 设置指令的背景颜色 el.style.backgroundColor = binding.value.color }) </pre> 指令函数可接受所有合法的 JavaScript 表达式,以下实例传入了 JavaScript 对象: <sample title="" desc="" lang="html" hererun="1"> <div id="app"> <div v-xiaobai="{ color: 'green', text: '小白教程!' }"></div> </div> <script> Vue.directive('xiaobai', function (el, binding) { // 简写方式设置文本及背景颜色 el.innerHTML = binding.value.text el.style.backgroundColor = binding.value.color }) new Vue({ el: '#app' }) </script> </sample> <run name=""> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Vue 测试实例 - 小白教程(xiaobai.wang)</title> <script src="https://cdn.staticfile.org/vue/3.2.31/vue.global.min.js"></script> </head> <body> <div id="app"> <div v-xiaobai="{ color: 'green', text: '小白教程!' }"></div> </div> <script> const app = Vue.createApp({}) app.directive('xiaobai', (el, binding, vnode) => { el.innerHTML = binding.value.text el.style.backgroundColor = binding.value.color }) app.mount('#app') </script> </body> </html> </run>
返回至“
Vue3 自定义指令
”。
上一节:
Vue3_表单
下一节:
Vue3_路由