Vue.js 的各种指令(Directives)更加方便我们去数据驱动 DOM,例如 v-bind、v-on、v-model、v-if、v-for、v-once 等内置指令,这些指令的职责就是当表达式改变时将某些行为应用到 DOM 上,尽量不去操作增删改 DOM。通过了解如何去自定义指令,可以想象内置指令是如何完成的。
内置指令
描述 | 使用 |
---|---|
自定义指令
注册
自定义指令的注册分为全局注册和局部注册,类似组件的注册,只是方法名为 directive,写法如下:
需要注意的是:Vue.directive( ) 注册指令要在实例初始化 new Vue( ) 之前才能全局注册指令。定义指令时驼峰式写法会报错,所以一般小写。
指令选项
自定义指令的选项是由几个钩子函数(可选)组成,可以根据需求选择不同的钩子,例如使用全局注册一个指令时:
以上每个钩子函数都有几个参数可用:
- el:指令所绑定的元素,可以用来直接操作 DOM;
- binding:包含指令信息的一个对象;
- vnode:Vue 编译的生成虚拟节点;
- oldVnode:上一次的虚拟节点,仅在update和componentUpdated钩子函数中可用。
示例
// 部分 JS 代码
export default {
directives:{
mytest: {
bind: function (el,binding,vnode) {
console.log(el)
console.log(binding)
console.log(vnode)
}
}
}
}
控制台输出截图:
- rawName: "v-mytest:foo.m1.m2" // 自定义指令
- name: "mytest" // 指令名称
- arg: "foo" // 指令的参数
- modifiers: {m1: true,m2: true} // 指令的修饰符
- expression: "1+1" // 指令绑定值的字符串形式
- value: 2 // 指令的绑定值
v-bind || : 绑定属性
Vue 内置指令 v-bind 用于动态更新 HTML 元素属性,使用 v-bind:someAttr = "someData"或者语法糖 :someAttr = "someData"就可以在 someData 改变时更新绑定的 someAttr 属性。
基本用法
绑定单一的属性值
测试 data 如下:
元素渲染输出:
对象语法
v-bind 最常用的是绑定 class 或 style 属性来动态改变样式。例如可以给 :class 设置一个对象来动态切换 class 的值:
当 isRed:true 时渲染输出:
对象中可以传入多个属性值来动态切换 class:
当 isA、isB 变化时 classA、classB 会动态更新,当都为 true 时显然渲染结果为:
同理对于 style 可以传入对象属性,并且可以使用字符串拼接:
对于元素中的各个对象可以统一用 v-bind 绑定:
数组语法
class 可以传入多值,给 :class 绑定一个数组就可以使用 class 列表
例如当 {activeA: 'class1',activeB: 'class2'} 时渲染结果为:
还可以在数组语法中使用三元表达式切换 class,例如:
在 class 有多个条件时使用三元表达式比较繁琐,可以在数组语法中使用对象语法:
修饰符
v-bind 的修饰符很少,API 中只提供.prop、.camel和.sync,并且多用于组件,使用方式示例:
<svg :view-Box.camel="viewBox">
<text-document v-bind:title.sync="doc.title">
<text-document v-bind.sync="doc">
v-on || @ 监听事件
v-on 用于动态绑定事件监听器,使用 v-on:someEvent = "someFunction"或者语法糖 @someEvent = "someFunction"就可以监听 someEvent 进行交互。
基本用法
可以在 methods 中添加函数:
点击 button 按钮后 a 元素的 id 改变:
当然 v-on 还可以使用对象语法监听多个事件:
对于在 HTML 元素上监听的事件,当 viewmodel 销毁时,所有的事件处理器会自动删除,无需自己清理。
修饰符
Vue 可以将原生事件对象参数 event 传入事件方法中,并提供了特殊变量$event用来访问元素 DOM 事件。此外可以通过一些事件修饰符来实现特定的事件,如 .stop、.prevent、.capture、.once 等,常用的使用示例:
<button @click.capture="doThis">
<button @click.once="doThis">
<button @click.left="doThis">
<button @click.stop.prevent="doThis">
此外,v-on 还提供按键修饰符来监听键盘事件,键值为 .keyCode,常用有.entry、.delete、.tab、.esc、.space、.down等,如下:
<input v-on:keyup.enter="submit">
<input @keyup.enter="submit">
此外还有系统修饰符监听键盘事件,不同的系统其键盘/系统修饰符不一样。这些按键修饰符可以任意组合使用。
v-if、v-show 条件渲染
条件渲染 v-if 根据表达式的值的真假条件渲染元素,在表达式为真时渲染,为假时移除。
v-show 也是条件渲染,但只切换元素的 CSS 属性 display,无论条件真假都会被编译,相比于 v-if 更适用于频繁切换场景。
当 data: {status: 2} 时隐藏,但依旧会被编译,渲染结果为:
显然在 Vue.js 内置的 元素上可以使用 v-if,但不能使用 v-show,可以思考下为什么。
v-for 列表渲染
列表渲染指令 v-for 常用于数组遍历或枚举一个对象的循环显示,必须结合 in 使用特定语法 alias in expression 为当前遍历的元素提供别名:
<div v-for="(item,index) in items">{{ index }} - {{ item.text }}
<div v-for="value in object">{{ value }}
<div v-for="(value,key) in object">{{ key }}: {{ value }}
<div v-for="(value,key,index) in object">{{ index }}. {{ key }}: {{ value }}
可以用 of 替代 in 作为分隔符
当 v-for 和 v-if 在同一节点一起使用时,v-for 的优先级比 v-if 更高。
v-model 表单控件双向绑定
v-model 其实也是一个特殊的语法糖,其实实现的数据双向绑定也可用v-bind和v-on实现,但v-model在不同表单上会有更加智能的处理。
文本框
经典的使用案例是对、
动态选择
对于单选按钮,复选框及选择框的选项,v-model配合 Vue 实例的数据作为value属性值实现不同效果,即会忽略所有表单元素的 value、checked、selected 特性的值。
Picked: {{ picked }}
修饰符
v-model的修饰符的使用限制在、
- .lazy - 取代 input 监听 change 事件
- .number - 输入字符串转为数字
- .trim - 输入首尾空格过滤
v-pre、v-cloak、v-once
这三个指令的共同点是无需表达式,用法如下: