学习 vue 的时候肯定会接触指令,那么什么是指令呢?
在 vue 中提供了一些对于页面和数据更为方便的输出,这些操作就叫做指令,以 v-xxx 表示,比如 html 页面中的属性<div v-xxx /div>比如在 angular 中 以 ng-xxx 开头的就叫做指令指令中封装了一些 DOM 行为,结合属性作为一个暗号,暗号有对应的值,根据不同的值,会进行相关 DOM 操作的绑定,即可以进行一些模板的操作vue中常用的一些内置v-xxx指令
v-text:元素的 innerText 属性,只能用在双标签中, 和{{ }}效果是一样的,使用较少v-html:元素的 innerHTML,其实就是给元素的 innerHTML 赋值v-show:元素的显示与隐藏,基于 css 样式的切换。如果确定要隐藏,会给元素的 style 加上display: nonev-if:元素的插入和移除操作,相当于对元素的销毁和创建。如果表达式的值为 false,会留下一个 <!---- 作为标记,若未来 v-if 的值是 true 了,就在这里插入元素(如果 if 有 else 就不要单独留坑了)。v-else-if:前一个相邻元素必须有 v-if 或 v-else-ifv-else:前一个相邻元素必须有 v-if 或 v-else-if,如果 v-if 和 v-else-if 都有对应的表达式,则 v-else 可以直接写v-for:用于循环渲染一组数据(数组或对象)。必须使用特定语法:v-for=“alias in expression”。注:当 v-for 和 v-if 同处于一个节点时,v-for 的优先级比 v-if 更高。即 v-if 将运行在每个 v-for循环中v-on:主要用来监听 dom 时间,然后执行一些操作。简写为【@】v-model:用于 input/textarea 等表单控件上创建双向数据绑定。v-bind:动态的绑定一个或多个属性,常用于绑定 class,style,href 等。v-once:组件和元素只渲染一次,当数据发生变化,也不会重新渲染。 二、自定义指令的钩子函数Vue 提供了自定义指令的5个钩子函数:
bind:指令第一次绑定到元素时调用,只执行一次。在这里可以进行一次性的初始化设置。inserted:被绑定的元素,插入到父节点的 DOM 中时调用(仅保证父节点存在)。update:组件更新时调用。componentUpdated:组件与子组件更新时调用。unbind:指令与元素解绑时调用,只执行一次。注意:
1、除 update 与 componentUpdated 钩子函数之外,每个钩子函数都含有 el、binding、vnode 这三个参数2、在每个函数中,第一个参数永远是 el, 表示被绑定了指令的那个 dom 元素,这个el 参数,是一个原生的 JS 对象 所以 Vue 自定义指令可以用来直接和 DOM 打交道3、binding 是一个对象,它包含以下属性:name、value、oldValue、expression、arg、modifiers4、oldVnode 只有在 update 与 componentUpdated 钩子中生效5、除了 el 之外,binding、vnode 属性都是只读的钩子函数说白了也就是生命周期,即当一个指令绑定到一个元素上时,这个指令内部有5个生命周期事件函数。接下来创建一个案例来看看这几个钩子函数的触发情况:
<p v-test>这是一段文字</p>?export default { ... ... directives: { test: { bind () { console.log('bind') }, inserted () { console.log('inserted') }, update () { console.log('update') }, componentUpdated () { console.log('componentUpdated') }, unbind () { console.log('unbind') } } }}
总结:
举几个应用场景的栗子:
1、输入框自动获取焦点(官方示例)。
2、点击下拉菜单以外的区域隐藏菜单。
3、输入的邮箱、电话的校验。
上面这几个场合,在做项目的时候可以用其他方法代替,但是 vue 自定义指令能做到一处定义,全局调用,使得代码简洁高效,更便于维护。
指令的注册方式和「过滤器」「混入」「组件」注册的方式一样都分为两种:一是全局注册,二是局部注册。
三、全局指令 // 给元素添加随机背景<div v-bgcolor></div> Vue.directive('bgcolor', { bind: function(el, binding, vnode) { el.style.backgroundColor = "#" + Math.random().toString(16).slice(2,8); }})注意:在定义的时候,指令的名称前面不需要加 v- 前缀,在调用的时候,必须在指定的名称前加上 v-前缀来进行调用
四、局部指令 // 和data, methods同级methods: {},directives: { bgcolor: { bind: function(el, binding) { el.style.backgroundColor = "#" + Math.random().toString(16).slice(2,8); } }}我个人更倾向于使用全局注册的方式,因为既然已经使用了自定义指令,应该是通用的可复用的。所以提供整个项目使用的指令才更有价值,而不仅仅只限于某个组件内部。如果单一地方使用直接把功能搂出来就行了,何必费这力气。
五、带参数的自定义指令 <div v-bgcolor='{color: 'orange'}'></div>Vue.directive('bgcolor', { bind: function(el, binding) { el.style.backgroundColor = binding.value.color; }}) 六、函数简写如果想在 bind 和 update 时触发相同行为,而不关心其它的钩子,可以这样写:
// 全局Vue.directive('bgcolor', function (el, binding) { el.style.backgroundColor = binding.value})// 局部directives: { bgcolor: (el, binding) => { el.style.backgroundColor = binding.value }} 七、应用实例熟悉指令的创建方式与参数之后,我们就用它来创建两个实际案例。
1、通过指令来实现点击空白处子菜单隐藏的功能,具体代码如下:
// clickOutside.jsexport default { bind (el, binding) { const self = {} // 定义一个私有变量,方便在unbind中可以解除事件监听 self.documentHandler = (e) => { if (el.contains(e.target)) { // 这里判断绑定的元素是否包含点击元素,如果包含则返回 return false } if (binding.value) { // 判断指令中是否绑定了值 binding.value(e) // 如果绑定了函数则调用那个函数,此处 binding.value就是handleClose方法 } return true } document.addEventListener('click', self.documentHandler) }, unbind (el) { // 解除事件监听 document.removeEventListener('click', self.documentHandler) delete self.documentHandler }}在组件中使用:
<template> <div> <div v-show="isShow" v-clickoutside="handleClickOutside" @click="showOrHide"> 子菜单 ... </div> </div></template>?<script> import clickoutside from './js/clickOutside' export default { ... ... directives: { clickoutside }, data() { return { isShow: true, }; }, methods: { handleOutsideClick () { this.isShow = false } } }</script>2、自定义指令来优化图片的加载:图片在加载过程中,未加载完成时使用灰色背景占位,图片加载完后直接显示
<template> <div> <!-- 参数不可以直接填写url地址--> <img v-imgUrl='url' /> </div></template>?<script> export default { data () { return { url: '../src/assets/logo.png' } } }</script>// 全局注册Vue.directive('imgUrl', function (el, binding) { el.style.backgroundColor = '#FEFEFE' //设置背景颜色 var img = new Image() img.src = binding.value // binding.value 指令后的参数 img.onload = function () { el.style.backgroundColor = '' el.src = binding.value }}) 27040208