除了默认设置的核心指令( v-model 和 v-show ), Vue 也允许注册自定义指令。
下面我们注册一个全局指令 v-focus, 该指令的功能是在页面加载时,元素获得焦点:
HTML
x
27
27
1
2
<html>
3
<head>
4
<meta charset="utf-8">
5
<title>Vue 测试实例 - Web176教程(web176.com)</title>
6
<script src="https://unpkg.com/vue@next"></script>
7
</head>
8
<body>
9
<div id="app">
10
<p>页面载入时,input 元素自动获取焦点:</p>
11
<input v-focus>
12
</div>
13
14
<script>
15
const app = Vue.createApp({})
16
// 注册一个全局自定义指令 `v-focus`
17
app.directive('focus', {
18
// 当被绑定的元素挂载到 DOM 中时……
19
mounted(el) {
20
// 聚焦元素
21
el.focus()
22
}
23
})
24
app.mount('#app')
25
</script>
26
</body>
27
</html>
我们也可以在实例使用 directives 选项来注册局部指令,这样指令只能在这个实例中使用:
HTML
xxxxxxxxxx
1
33
33
1
2
<html>
3
<head>
4
<meta charset="utf-8">
5
<title>Vue 测试实例 - Web176教程(web176.com)</title>
6
<script src="https://unpkg.com/vue@next"></script>
7
</head>
8
<body>
9
<div id="app">
10
<p>页面载入时,input 元素自动获取焦点:</p>
11
<input v-focus>
12
</div>
13
14
<script>
15
const app = {
16
data() {
17
return {
18
}
19
},
20
directives: {
21
focus: {
22
// 指令的定义
23
mounted(el) {
24
el.focus()
25
}
26
}
27
}
28
}
29
30
Vue.createApp(app).mount('#app')
31
</script>
32
</body>
33
</html>
钩子
钩子函数
指令定义函数提供了几个钩子函数(可选):
created
: 在绑定元素的属性或事件监听器被应用之前调用。beforeMount
: 指令第一次绑定到元素并且在挂载父组件之前调用。。mounted
: 在绑定元素的父组件被挂载后调用。。beforeUpdate
: 在更新包含组件的 VNode 之前调用。。updated
: 在包含组件的 VNode 及其子组件的 VNode 更新后调用。beforeUnmount
: 当指令与在绑定元素父组件卸载之前时,只调用一次。unmounted
: 当指令与元素解除绑定且父组件已卸载时,只调用一次。
看个例子:
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')
钩子函数参数
钩子函数的参数有:
el
el 指令绑定到的元素。这可用于直接操作 DOM。
binding
binding 是一个对象,包含以下属性:
instance
:使用指令的组件实例。value
:传递给指令的值。例如,在v-my-directive="1 + 1"
中,该值为2
。oldValue
:先前的值,仅在beforeUpdate
和updated
中可用。值是否已更改都可用。arg
:参数传递给指令 (如果有)。例如在v-my-directive:foo
中,arg 为"foo"
。modifiers
:包含修饰符 (如果有) 的对象。例如在v-my-directive.foo.bar
中,修饰符对象为{foo: true,bar: true}
。dir
:一个对象,在注册指令时作为参数传递。例如,在以下指令中:
app.directive('focus', {
mounted(el) {
el.focus()
}
})
dir 将会是以下对象:
{
mounted(el) {
el.focus()
}
}
vnode
作为 el 参数收到的真实 DOM 元素的蓝图。
prevNode
上一个虚拟节点,仅在 beforeUpdate 和 updated 钩子中可用。
以下实例演示了这些参数的使用:
HTML
xxxxxxxxxx
1
24
24
1
2
<html>
3
<head>
4
<meta charset="utf-8">
5
<title>Vue 测试实例 - Web176教程(web176.com)</title>
6
<script src="https://cdn.staticfile.org/vue/3.2.31/vue.global.min.js"></script>
7
</head>
8
<body>
9
<div id="app">
10
<div v-web176="{ name: 'Web176教程', url: 'www.web176.com' }"></div>
11
</div>
12
13
<script>
14
const app = Vue.createApp({})
15
app.directive('Web176', (el, binding, vnode) => {
16
console.log(binding.value.name) // => "Web176教程"
17
console.log(binding.value.url) // => "www.web176.com"
18
var s = JSON.stringify
19
el.innerHTML = s(binding.value)
20
})
21
app.mount('#app')
22
</script>
23
</body>
24
</html>
有时候我们不需要其他钩子函数,我们可以简写函数,如下格式:
Vue.directive('runoob', function (el, binding) {
// 设置指令的背景颜色
el.style.backgroundColor = binding.value.color
})
指令函数可接受所有合法的 JavaScript 表达式,以下实例传入了 JavaScript 对象:
HTML
xxxxxxxxxx
1
22
22
1
2
<html>
3
<head>
4
<meta charset="utf-8">
5
<title>Vue 测试实例 - Web176教程(web176.com)</title>
6
<script src="https://cdn.staticfile.org/vue/3.2.31/vue.global.min.js"></script>
7
</head>
8
<body>
9
<div id="app">
10
<div v-web176="{ color: 'red', text: 'Web176教程!' }"></div>
11
</div>
12
13
<script>
14
const app = Vue.createApp({})
15
app.directive('web176', (el, binding, vnode) => {
16
el.innerHTML = binding.value.text
17
el.style.backgroundColor = binding.value.color
18
})
19
app.mount('#app')
20
</script>
21
</body>
22
</html>
阅读剩余 85%
作者:terry,如若转载,请注明出处:https://www.web176.com/vue3/6226.html