Vue.directive()自定义指令的用法和实例

定义全局自定义指令

注意:Vue.directive(‘参数名称’,{}) 定义全局指令,它有两个参数

参数1:指令名称,注意在定义的时候,指令名称前不需要加 v- 前缀,但是在调用的时候,必须加v- 前缀。
参数2:参数2是一个对象,这个对象身上有一些指令相关的函数(也就是下边介绍的钩子函数),这些函数可以在特定的阶段,执行相关操作。

 <div>
    <!-- 让input元素在打开页面的时候就获得焦点 -->
    <input type="text" v-autoFocus >
  </div>


Vue.directive('autoFcs',{
  // 钩子函数,被绑定元素插入父节点时调用 (父节点存在即可调用,不必存在于 document 中)。
  inserted(el){
    el.focus()
    console.log( 'inserted' );
  },
  // 只调用一次,指令第一次绑定到元素时调用,用这个钩子函数可以定义一个在绑定时执行一次的初始化动作。
  bind(){
    console.log( 'bind' );
  },
  // 所在组件的 VNode 更新时调用,但是可能发生在其孩子的 VNode 更新之前。
  // 指令的值可能发生了改变也可能没有。但是你可以通过比较更新前后的值来忽略不必要的模板更新 
  update(){
    console.log( 'update' );
  },
  // 所在组件的 VNode 及其孩子的 VNode 全部更新时调用。
  componentUpdated(){
    console.log( 'componentUpdated' );
  },
  // 只调用一次,指令与元素解绑时调用。
  unbind(){
    console.log( 'unbind' );
  }
})

Vue局部自定义指令
注意:局部自定义指令 有两个条件【指令名称 和 指令对象】

<div id="app>
	<h5 v-color>我是局部自定义指令</h5>
</div>

<script>
	var vm = new Vue({
		el:'#app',
		date:{},
		methods:{},
		directives:{
			'color':{//给字体设置颜色
				bind:function(el){ //这个function() 中还有第二个参数 binding ,这里不做介绍,在下边钩子函数参数中介绍
					el.style.color="red";
				}
			}
		}
	})
</script>

注:全局用的是 directive,局部用的是directives

Vue钩子函数
一个指令对象可以提供以下钩子函数(前三个是常用的)

bind :只调用一次,每当指令绑定到元素上的时候,会立即执行这个 bind 函数。
1.在上边自动获取焦点的案例中,在元素 刚绑定指令的时候,还没有插入到 DOM 中去,这个时候调用 focus 方法没有作用,因为一个元素,只有插入DOM之后,才能获取焦点,所以这个函数不能获取焦点
2.样式设置;只要通过指令绑定给了元素,不管这个元素有没有插入到页面中,这个元素肯定有一个内联样式,将来元素肯定会渲染显示到页面中去,这个时候,浏览器的渲染引擎必然会解析样式,然后应用这个样式。

注:一般和样式操作有关的,一般都可以在 bind 函数中执行
  1. inserted : 表示元素 插入到DOM中的时候,会执行 inserted 函数,触发一次。(例如:自动获取焦点)
注:和 JS 行为有关系的操作,最好在 inserted 中去执行,防止 JS 行为不生效。
  1. updated : 当VNode 更新的时候,会执行 updated 函数,可能会触发多次

  2. componentUpdated : 指令所在组件的VNode 及其子 VNode 全部更新后调用。

  3. upbind: 只调用一次,指令与元素解绑时调用。

Vue钩子函数传参数详解
上边也有介绍,钩子函数有四个参数。一个是指令所绑定的元素,用来直接操作DOM;另外一个是一个对象,它包含一些属性。另外两个了解。
通过一些例子来了解一下:

  • el : 指令所绑定的元素,规定的也是每个钩子函数中的第一个参数,永远不会改变,这个 el 参数,是一个原生的JS 的 DOM对象

  • binding: 第二个参数是一个对象,它包含一些属性(前三个常用,但是其他的也要知道)

    1. name:指令名,不包括 v- 前缀。

    2. value: 指令绑定的值,例如:v-count="1 + 1"中,绑定值为 2

    3. expression: 字符串形式的指令表达式。例如:v-count="1 + 1"中,表达式 为 1 + 1

    4. oldValue: 指令绑定的前一个值,仅在 update 和 componentUpdated 钩子中可用。无论值是否改变都可用。
      `

    5. arg:` 传给指令的参数,可选。例如 v-my-directive:foo 中,参数为 “foo”

    6. modifiers: 一个包含修饰符的对象。例如:v-my-directive.foo.bar 中,修饰符对象为{ foo: true, bar: true }

  • vnode: Vue 编译生成的虚拟节点。

  • oldVnode: 上一个虚拟节点,仅在 update 和 componentUpdated 钩子中可用

    注:除了 el 之外,其它参数都应该是只读的,切勿进行修改。如果需要在钩子之间共享数据,建议通过元素的 dataset 来进行。
    
<div id="app">
	//注意:v-color=" 'yellow' "  里边是单引号引着(因为value属性)
	<p v-color=" 'yellow' " v-fontsize=" '50px' ">钩子函数的传参</p>
</div>

<script>
	//全局自定义指令写法
	Vue.directive('color',{
		bind:function(el,binding){
			el.style.color=binding.value;
		}
	})


	//局部自定义指令写法
	var vm = new Vue({
		el:'#app',
		data:{},
		methods:{},
		directives:{
			'fontsize':{//设置字体大小
				bind:function(el,binding){
					el.style.fontSize=binding.value;
					
					//增强代码健壮性的一种写法(不管给指令赋值带不带 px ,都会先转化为整数)
					//el.style.fontSize = parseInt(binding.value) + 'px'
				}
			}
		}
	})

</script>
注:钩子函数中的参数,不是一定起名是 el 或者 binding 的,一定要明白原理,他们只不过是形参而已,名字可以不一样,但是他们代表的含义是Vue内部规定好的!

钩子函数简写或者合并

在有的时候,可能bind 和 update触发相同行为,不关其他钩子函数的事。
<div id="app">
	<p v-fontsize=" '50px' ">钩子函数的传参</p>
</div>

<script>
	var vm = new Vue({
		el:'#app',
		data:{},
		methods:{},
		directives:{
			'fontsize':function(el,binding){ //注意:这个 function 等同于把代码写到了 bind 和 update 中去
				el.style.fontSize=binding.value;
			}
		}
	
	})

</script>
已标记关键词 清除标记
相关推荐
©️2020 CSDN 皮肤主题: 游动-白 设计师:白松林 返回首页