JennyTong
JennyTong

Vue 通过自定义指令回顾v-内置指令(小结)

Vue.js 的各种指令（Directives）更加方便我们去数据驱动 DOM，例如 v-bind、v-on、v-model、v-if、v-for、v-once 等内置指令，这些指令的职责就是当表达式改变时将某些行为应用到 DOM 上，尽量不去操作增删改 DOM。通过了解如何去自定义指令，可以想象内置指令是如何完成的。

内置指令

指令名称 描述 使用
v-model 绑定数据 <\input v-model="message">
v-text 输出文本,不能解析标签 <\p v-text="message">
v-html 输出文本,可解析标签 <\p v-html="message">/p>
v-once 只绑定一次数据 <\p v-once >{{message}}
v-bind 绑定属性 <\img v-bind:src="imgurl"> 或 <\img :src="imgurl">
v-if 控制是否显示容器 值转为布尔为false时 注释该容器，反之显示 <\div v-if="true">
v-show 控制是否显容器，改变的时display:none/block <\div v-show="true">
v-for 循环遍历数组、对象 <\li v-for="(val,key) in arr">{{val}}
v-cloak 在还没有执行到vue代码的时候隐藏元素,可解决‘闪烁'问题 <\p v-cloak>{{message}}

自定义指令

在需要特殊功能时，使用自定义指令对 DOM 进行底层操作

注册

自定义指令的注册分为全局注册和局部注册，类似组件的注册，只是方法名为 directive，写法如下：

// 全局注册 自定义指令
Vue.directive(‘mydir',{
  // 指令选项
});
// 全局注册 自定义指令函数
Vue.directive('mydir', function () {
 // 这里将会被 `bind` 和 `update` 调用
})
// 局部注册（只针对组件内元素）
export default {
  directives: {
    mydir: {
      // 指令选项
    }
  }
}

需要注意的是：Vue.directive( ) 注册指令要在实例初始化 new Vue( ) 之前才能全局注册指令。定义指令时驼峰式写法会报错，所以一般小写。

指令选项

自定义指令的选项是由几个钩子函数（可选）组成，可以根据需求选择不同的钩子，例如使用全局注册一个指令时：

Vue.directive('mydir', {
 bind: function () {
  // 只调用一次，指令第一次绑定到元素时调用，用于在绑定元素时执行一次的初始化动作。
  },
 update: function () {
  // 第一次是紧跟在 bind 之后调用，获得的参数是绑定的初始值，
  // 之后被绑定元素所在的模板更新时调用，而不论绑定值是否变化，可以忽略不必要的模板更新。  
  }, 
 inserted: function () {
  // 被绑定元素插入父节点时调用（父节点存在即可调用，不必存在于 document 中）。
  },
 componentUpdated: function () {
  // 被绑定元素所在模板完成一次更新周期时调用。
  },
 unbind: function () {
  // 只调用一次， 指令与元素解绑时调用。
  }
})

以上每个钩子函数都有几个参数可用：

  1. el：指令所绑定的元素，可以用来直接操作 DOM；
  2. binding：包含指令信息的一个对象；
  3. vnode：Vue 编译的生成虚拟节点；
  4. oldVnode：上一次的虚拟节点，仅在update和componentUpdated钩子函数中可用。

示例

// 一个带自定义指令的元素

MyDirective


// 部分 JS 代码
export default {
  directives:{
   mytest: {
    bind: function (el, binding, vnode) {
     console.log(el)
     console.log(binding)
     console.log(vnode)
    }
   }
  }
}

控制台输出截图：

其中对于 binding 对象输出的属性有：

  1. rawName: "v-mytest:foo.m1.m2" // 自定义指令
  2. name: "mytest" // 指令名称
  3. arg: "foo" // 指令的参数
  4. modifiers: {m1: true, m2: true} // 指令的修饰符
  5. expression: "1+1" // 指令绑定值的字符串形式
  6. value: 2 // 指令的绑定值

v-bind || : 绑定属性

Vue 内置指令 v-bind 用于动态更新 HTML 元素属性，使用 v-bind:someAttr = "someData"或者语法糖 :someAttr = "someData"就可以在 someData 改变时更新绑定的 someAttr 属性。

基本用法

绑定单一的属性值

链接

测试 data 如下：

// js
data : {
  url: 'https://www.baidu.com/',
  linkID : 'myid'
}

元素渲染输出：

链接

对象语法

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，并且多用于组件，使用方式示例：

v-on || @ 监听事件

v-on 用于动态绑定事件监听器，使用 v-on:someEvent = "someFunction"或者语法糖 @someEvent = "someFunction"就可以监听 someEvent 进行交互。

基本用法

@someEvent 调用的方法名后面可以不跟（），例如：

链接

可以在 methods 中添加函数：

// 部分 JS 代码
methods :{
 changeFun : function () {
  this.linkID = 'changeID' // 指向当前组件本身
 }
}

点击 button 按钮后 a 元素的 id 改变：

链接

当然 v-on 还可以使用对象语法监听多个事件：

对于在 HTML 元素上监听的事件，当 ViewModel 销毁时，所有的事件处理器会自动删除，无需自己清理。

修饰符

Vue 可以将原生事件对象参数 event 传入事件方法中，并提供了特殊变量$event用来访问元素 DOM 事件。此外可以通过一些事件修饰符来实现特定的事件，如 .stop、.prevent、.capture、.once 等，常用的使用示例：

此外，v-on 还提供按键修饰符来监听键盘事件，键值为 .keyCode，常用有.entry、.delete、.tab、.esc、.space、.down等，如下：

此外还有系统修饰符监听键盘事件，不同的系统其键盘/系统修饰符不一样。这些按键修饰符可以任意组合使用。

v-if、v-show 条件渲染

条件渲染 v-if 根据表达式的值的真假条件渲染元素，在表达式为真时渲染，为假时移除。

当 status 为 1 时显示此行



当 status 为 2 时显示此行



其它情况默认显示此行

v-show 也是条件渲染，但只切换元素的 CSS 属性 display，无论条件真假都会被编译，相比于 v-if 更适用于频繁切换场景。

当 status 为 1 时显示此行

当 data: {status: 2} 时隐藏，但依旧会被编译，渲染结果为：

当 status 为 1 时显示此行

显然在 Vue.js 内置的