vue自定义指令

什么是指令?

指令 (Directives) 是带有 v- 前缀的特殊属性。 它可以写在DOM元素上,对html进行操作。常用的指令比如有:v-if,v-else,v-show,v-for等。这些都是官方直接给定的,另外Vue也允许注册自定义指令,有时这很有用。

自定义指令方法

自定义一个指令很简单,官网给出一个简单的例子,自定义一个聚焦指令v-focus:

// 注册一个全局自定义指令 `v-focus`
Vue.directive(‘focus‘, {
  // 当被绑定的元素插入到 DOM 中时……
  inserted: function (el) {
    // 聚焦元素
    el.focus()
  }
})

上面几行代码就全局注册了一个指令并可以执行,当给一个输入框加上这个指令时,页面加载就会使该框获得焦点。

<input v-focus>

说明:

‘focus‘:如你所见,是指令的名称,不带v-前缀;

inserted:这是一个钩子函数,表示被绑定元素插入父节点时调用,指令定义函数提供了多个钩子函数,下面再介绍。

另外,你也可以局部注册指令,组件中也接受一个 directives 的选项:

directives: {
  focus: {
    // 指令的定义
    inserted: function (el) {
      el.focus()
    }
  }
}

钩子函数介绍

指令定义函数提供了几个钩子函数(可选)

  • bind:只调用一次,指令第一次绑定到元素时调用。
  • inserted:被绑定元素插入父节点时调用。
  • update:所在组件的VNode更新时调用,但是可能发生在其子 VNode 更新之前。
  • componentUpdated:指令所在组件的 VNode 及其子 VNode 全部更新后调用。
  • unbind:只调用一次,指令与元素解绑时调用。

他们中每一个都有相同的三个参数:el,binding和vnode,在update和componentUpdated中,还会有参数oldVnode,以区分传递的旧值和新值。

  • el:指令所绑定的元素,可以用来直接操作 DOM 。
  • binding:一个对象,包含以下属性:name,value,oldValue,expression,arg和modifiers。
  • vnode:Vue 编译生成的虚拟节点。
  • oldVnode:上一个虚拟节点,仅在 update 和 componentUpdated 钩子中可用。

注意:除了 el 之外,其它参数都应该是只读的。

其中,你注意到binding参数中有多个属性,要搞清楚他们分别代表了什么,这很重要。

<div id="app">
    <p v-demo:foo.a.b="message"></p>
</div>
Vue.directive(‘demo‘,{
    bind(el, binding, vnode){
        //给绑定的元素添加内容
        el.innerHTML = `
        name:${binding.name};<br>
        value:${binding.value};<br>
        expression:${binding.expression};<br>
        argument:${binding.arg};<br>
        modifiers:${JSON.stringify(binding.modifiers)};
        `
    }
});

new Vue({
    el:‘#app‘,
    data:{
        message:"hello"
    }
});

结果:

name:demo; //指令名,不包括 v- 前缀
value:hello; //指令的绑定值
expression:message; //字符串形式的指令表达式
argument:foo; //传给指令的参数,可选。
modifiers:{"a":true,"b":true}; //一个包含修饰符的对象。

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

到这里,你可能有点糊涂了,东西看起来有点多,其实并不是,你只是不熟悉。这些官网介绍的很清楚,你需要的是一个更具体的例子。

写一个自己的指令

现在来创建一个自定义指令,比如我想创建一个可以操作定位的指令,就叫他 v-position

Vue.directive(‘position‘,{
    bind(el, binding, vnode){
        el.style.position = ‘fixed‘;
        el.style.top = binding.value + ‘px‘;
    }
});
<div id="app">
    <p v-position=‘100‘>我距离顶部100px</p>
</div>

现在v-position只能控制到顶部的距离,我们还可以自由控制方向:

<p v-position:left=‘50‘>我距离左侧50px</p>
Vue.directive(‘position‘,{
    bind(el, binding, vnode){
        el.style.position = ‘fixed‘;
        let d = (binding.arg == ‘top‘?‘top‘:‘left‘);
        el.style[d] = binding.value + ‘px‘;
    }
});

另外,你还可以控制多个值:

<p v-position="{top:‘100‘,left:‘50‘}">我距离左侧50px,距离顶部100px</p>
Vue.directive(‘position‘,{
    bind(el, binding, vnode){
        el.style.position = ‘fixed‘;
        el.style.top = binding.value.top + ‘px‘;
        el.style.left = binding.value.left + ‘px‘;
    }
});

这就是vue自定义指令的一些简单应用,你可以创建出更高级灵活的自定义指令。

时间: 2024-07-31 23:42:16

vue自定义指令的相关文章

vue自定义指令(Directive中的clickoutside.js)的理解

.array p { counter-increment: longen; margin-left: 10px } .array p::before { content: counter(longen) "." } .alink { font-size: 16px; color: blue } 阅读目录 vue自定义指令clickoutside.js的理解 回到顶部 vue自定义指令clickoutside.js的理解 vue自定义指令请看如下博客: vue自定义指令 一般在需要 DO

vue自定义指令clickoutside使用以及扩展用法

vue自定义指令clickoutside使用以及扩展用法 产品使用vue+element作为前端框架.在功能开发过程中,难免遇到使用element的组件没办法满足特殊的业务需要,需要对其进行定制,例如要求选择器的弹出框中,增加搜索过滤(跟目前element的输入建议不太一样).于是想说说之前修改element组件,并定制为业务组件过程中遇到的问题. ps:因为对某些组件改动很大,所以是直接拷贝了一份源码,然后再进行修改,但是这样会遇到挺多问题,建议对于vue组件如果改动不大,只是简单功能扩展,就

使用vue自定义指令合并iview表格单元格

使用vue自定义指令合并iview表格单元格, 我们在开发过程中发现iview表格组件,官网只提供了合并表头的demo,并没有合并表格中的单元格. ivew表头分组:https://www.iviewui.com/components/table#BTFZ 效果图如下: 具体实现思路,通过vue自定义属性来操作dom,达到我们想要的效果: 代码如下: demo.vue  表格页面 <template> <div class="demo"><Table :c

Vue 自定义指令练习

Vue.directive(id,definition)注册一个全局自定义指令,接收两个参数,指令ID以及定义对象 取值: <div v-demo="{ color: 'white', text: 'hello!' }"></div> Vue.directive("demo", function (el, binding) { alert(binding.value.color); alert(binding.value.text); })

vue 自定义指令

除了默认设置的核心指令(v-model和v-show),vue也允许注册自定义指令.在vue2.0版本中,代码复用的主要形式和抽象是组件--然而,有的情况下,你仍然需要对DOM元素进行底层操作,这时候就会用到自定义指令. 当页面加载时,元素将获得焦点(注意:autoFocus在移动版safari中不工作),事实上,你访问后,还没点击任何内容,input就获得了焦点.现在让我们完善这个指令: // 注册一个全局自定义指令 v-focus Vue.directive('focus', { // 当绑

vue 自定义指令directive

//自定义指令:directive 的传参--可以数据也可以是字符串 Vue.directive('scroll', function (binding) { window.addEventListener('scroll', function () { if (document.body.scrollTop + window.innerHeight >= document.body.clientHeight-20) { var fnc = binding; fnc(); } }) }); 调用

vue自定义指令的创建和使用

一.自定义指令的创建和使用 Vue自带的指令很多,v-for/v-if/v-else/v-else-if/v-model/v-bind/v-on/v-show/v-html/v-text...但是这些指令都是比较偏向于工具化,有些时候在实现具体的业务逻辑的时候,发现不够用,如何来自定义指令. 1.自定义指令①创建 new Vue({ directives:{ change:{ bind:function(){}, update:function(){}, unbind:function(){}

Vue自定义指令获取DOM元素

我们知道,Vue.js的核心是数据驱动,当数据有所变化时,DOM就会被更新,比如: <span v-text="msg"></span> export default { data(){ return{ msg : 'oldMsg' } } methods : { changeMsg : function(){ this.msg = 'newMsg' } } } 当调用了changeMsg方法,msg被修改为 ' newMsg ' ,我们可以把这次修改理解为数据

Vue自定义指令和路由

一.自定义指令 除了默认设置的核心指令( v-model 和 v-show ), Vue 也允许注册自定义指令. 下面我们注册一个全局指令 v-focus,该指令的功能是在页面加载时,元素获得焦点: <div id="app"> <p>页面载入时,input 元素自动获取焦点:</p> <input v-focus> </div> <script> // 注册一个全局自定义指令 v-focus Vue.direct