vue.js 可复用性&组合- 混合 - 自定义指令 - 插件 基础

vue的复用性与组合

混合

混合 (mixins) 是一种分发 Vue 组件中可复用功能的很是灵活的方式。混合对象能够包含任意组件选项。以组件使用混合对象时,全部混合对象的选项将被混入该组件自己的选项。javascript

Vue.extend()用以建立没有挂载的的子类,可使用该子累建立多个实例
[javascript] view plain copy

var Profile = Vue.extend({  
             template: '<p>{{firstName}} {{lastName}} aka {{alias}}</p>',  
             data: function () {  
               return {  
                 firstName: 'Walter',  
                 lastName: 'White',  
                 alias: 'Heisenberg'  
               }  
             }  
           })  
           // 建立 Profile 实例,并挂载到一个元素上。  
           new Profile().$mount('#mount-point')
mixins 将两个的对象的混合为一个数组,彼此均可以被调用,下面为演示代码及其结果

当对象键值对 键名冲突时,保留非mixin对象的键值对
<div id="app"></div>  
       <script>  
           var myMixin={  
               template:'<h1>holle mixin</h1>',  
               methods:{  
                   hello:function(){  
                       console.log('this is mixin')  
                   },  
                   say:function(){  
                       console.log('I am mixin')  
                   }  
               }  
           };  
  
           var Component=Vue.extend({  
               mixins:[myMixin],  
               methods:{  
                   lsit:function(){  
                       console.log('I am lsit')  
                   },  
                   say:function(){  
                        console.log('I am mixin say')  
                   }  
               }  
  
           });  
           var newcom=new Component().$mount('#app')  
           newcom.hello();  
           newcom.lsit();  
           newcom.say();  
       </script>

全局混合

也能够全局注册混合对象。 注意使用! 一旦使用全局混合对象,将会影响到 全部 以后建立的 Vue 实例。使用恰当时,能够为自定义对象注入处理逻辑。html

// 为自定义的选项 'myOption' 注入一个处理器。
Vue.mixin({
  created: function () {
    var myOption = this.$options.myOption
    if (myOption) {
      console.log(myOption)
    }
  }
})
new Vue({
  myOption: 'hello!'
})
// => "hello!"

谨慎使用全局混合对象,由于会影响到每一个单首创建的 Vue 实例(包括第三方模板)。大多数状况下,只应当应用于自定义选项,就像上面示例同样。 也能够将其用做 Plugins 以免产生重复应用vue

自定义指令

Vue.js 容许你注册自定义指令,实质上是让你教 Vue 一些新技巧:怎样将数据的变化映射到 DOM 的行为。你可使用Vue.directive(id, definition)的方法传入指令id和定义对象来注册一个全局自定义指令。定义对象须要提供一些钩子函数(所有可选):java

  • bind: 仅调用一次,当指令第一次绑定元素的时候。node

  • update: 第一次是紧跟在 bind 以后调用,得到的参数是绑定的初始值;之后每当绑定的值发生变化就会被调用,得到新值与旧值两个参数。webpack

  • unbind:仅调用一次,当指令解绑元素的时候。web

例子:vue-router

Vue.directive('my-directive', {
  bind: function () {
    // 作绑定的准备工做
    // 好比添加事件监听器,或是其余只须要执行一次的复杂操做
  },
  update: function (newValue, oldValue) {
    // 根据得到的新值执行对应的更新
    // 对于初始值也会被调用一次
  },
  unbind: function () {
    // 作清理工做
    // 好比移除在 bind() 中添加的事件监听器
  }
})
一旦注册好自定义指令,你就能够在 Vue.js 模板中像这样来使用它(须要添加 Vue.js 的指令前缀,默认为 v-):
<div v-my-directive="someValue"></div>
若是你只须要 update 函数,你能够只传入一个函数,而不用传定义对象:
Vue.directive('my-directive', function (value) {
  // 这个函数会被做为 update() 函数使用
})

全部的钩子函数会被复制到实际的指令对象中,而这个指令对象将会是全部钩子函数的this
上下文环境。指令对象上暴露了一些有用的公开属性:express

  • el: 指令绑定的元素数组

  • vm: 拥有该指令的上下文 ViewModel

  • expression: 指令的表达式,不包括参数和过滤器

  • arg: 指令的参数

  • raw: 未被解析的原始表达式

  • name: 不带前缀的指令名

这些属性是只读的,不要修改它们。你也能够给指令对象附加自定义的属性,可是注意不要覆盖已有的内部属性。

钩子函数

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

* bind: 只调用一次,指令第一次绑定到元素时调用,用这个钩子函数能够定义一个在绑定时执行一次的初始化动做。

* inserted: 被绑定元素插入父节点时调用(父节点存在便可调用,没必要存在于 document 中)。

* update: 所在组件的 VNode 更新时调用,可是可能发生在其孩子的 VNode 更新以前。指令的值可能发生了改变也可能没有。可是你能够经过比较更新先后的值来忽略没必要要的模板更新 (详细的钩子函数参数见下)。

* componentUpdated: 所在组件的 VNode 及其孩子的 VNode 所有更新时调用。

* unbind: 只调用一次, 指令与元素解绑时调用。

* 接下来咱们来看一下钩子函数的参数 (包括 el,binding,vnode,oldVnode) 。

钩子函数参数

钩子函数被赋予了如下参数:

*el: 指令所绑定的元素,能够用来直接操做 DOM 。
* binding: 一个对象,包含如下属性:

* name: 指令名,不包括 v- 前缀。
* value: 指令的绑定值, 例如: v-my-directive="1 + 1", value 的值是 2。
* oldValue: 指令绑定的前一个值,仅在 update 和 componentUpdated 钩子中可用。不管值是否改变均可用。
* expression: 绑定值的字符串形式。 例如 v-my-directive="1 + 1" , expression 的值是 "1 + 1"。
* arg: 传给指令的参数。例如 v-my-directive:foo, arg 的值是 "foo"。
* modifiers: 一个包含修饰符的对象。 例如: v-my-directive.foo.bar, 修饰符对象 modifiers 的值是 { foo: true, bar: true }。
* vnode: Vue 编译生成的虚拟节点,查阅 VNode API 了解更多详情。
* oldVnode: 上一个虚拟节点,仅在 update 和 componentUpdated 钩子中可用。
  • 除了 el 以外,其它参数都应该是只读的,尽可能不要修改他们。若是须要在钩子之间共享数据,建议经过元素的 dataset 来进行。

多重从句

同一个特性内部,逗号分隔的多个从句将被绑定为多个指令实例。在下面的例子中,指令会被建立和调用两次:

<div v-demo="color: 'white', text: 'hello!'"></div>

若是想要用单个指令实例处理多个参数,能够利用字面量对象做为表达式:

<div v-demo="{color: 'white', text: 'hello!'}"></div>

    Vue.directive('demo', function (value) {
    
          console.log(value) // Object {color: 'white', text: 'hello!'}
})

字面指令

若是在建立自定义指令的时候传入 isLiteral: true ,那么特性值就会被当作直接字符串,并被赋值给该指令的 expression。字面指令不会试图创建数据监视。

例子:

<div v-literal-dir="foo"></div>
Vue.directive('literal-dir', {
      isLiteral: true,
      bind: function () {
        console.log(this.expression) // 'foo'
      }
    })

动态字面指令

然而,在字面指令含有 Mustache 标签的情形下,指令的行为以下:

指令实例会有一个属性,this._isDynamicLiteral被设为true;

若是没有提供update函数,Mustache 表达式只会被求值一次,并将该值赋给this.expression。不会对表达式进行数据监视。

若是提供了update函数,指令将会为表达式创建一个数据监视,而且在计算结果变化的时候调用update。

双向指令

若是你的指令想向 Vue 实例写回数据,你须要传入 twoWay: true 。该选项容许在指令中使用
this.set(value)。

Vue.directive('example', {
  twoWay: true,
  bind: function () {
    this.handler = function () {
      // 把数据写回 vm
      // 若是指令这样绑定 v-example="a.b.c",
      // 这里将会给 `vm.a.b.c` 赋值
      this.set(this.el.value)
    }.bind(this)
    this.el.addEventListener('input', this.handler)
  },
  unbind: function () {
    this.el.removeEventListener('input', this.handler)
  }
})

内联语句

传入 acceptStatement: true 可让自定义指令像 v-on 同样接受内联语句:

<div v-my-directive="a++"></div>
Vue.directive('my-directive', {
  acceptStatement: true,
  update: function (fn) {
    // the passed in value is a function which when called,
    // will execute the "a++" statement in the owner vm's
    // scope.
  }
})

可是请明智地使用此功能,由于一般咱们但愿避免在模板中产生反作用。

元素指令

有时候,咱们可能想要咱们的指令能够以自定义元素的形式被使用,而不是做为一个特性。这与 Angular 的 E 类指令的概念很是类似。元素指令能够看作是一个轻量的自定义组件(后面会讲到)。你能够像下面这样注册一个自定义的元素指令:

Vue.elementDirective('my-directive', {
  // 和普通指令的 API 一致
  bind: function () {
    // 对 this.el 进行操做...
  }
})

使用时咱们再也不用这样的写法:

<div v-my-directive></div>

而是写成:

<my-directive></my-directive>

元素指令不能接受参数或表达式,可是它能够读取元素的特性,来决定它的行为。与一般的指令有个很大的不一样,元素指令是终结性的,这意味着,一旦 Vue 遇到一个元素指令,它将跳过对该元素和其子元素的编译 - 即只有该元素指令自己能够操做该元素及其子元素。

插件

开发插件

  • 插件一般会为Vue添加全局功能。插件的范围没有限制——通常有下面几种:

  • 添加全局方法或者属性,如: vue-custom-element

  • 添加全局资源:指令/过滤器/过渡等,如 vue-touch

  • 经过全局 mixin 方法添加一些组件选项,如: vue-router

  • 添加 Vue 实例方法,经过把它们添加到 Vue.prototype 上实现。

  • 一个库,提供本身的 API,同时提供上面提到的一个或多个功能,如 vue-router

Vue.js 的插件应当有一个公开方法 install 。这个方法的第一个参数是 Vue 构造器 , 第二个参数是一个可选的选项对象:

MyPlugin.install = function (Vue, options) {
  // 1. 添加全局方法或属性
  Vue.myGlobalMethod = function () {
    // 逻辑...
  }
  // 2. 添加全局资源
  Vue.directive('my-directive', {
    bind (el, binding, vnode, oldVnode) {
      // 逻辑...
    }
    ...
  })
  // 3. 注入组件
  Vue.mixin({
    created: function () {
      // 逻辑...
    }
    ...
  })
  // 4. 添加实例方法
  Vue.prototype.$myMethod = function (methodOptions) {
    // 逻辑...
  }
}

使用插件

经过全局方法 Vue.use() 使用插件:
// 调用 `MyPlugin.install(Vue)`
Vue.use(MyPlugin)
也能够传入一个选项对象:
Vue.use(MyPlugin, { someOption: true })

Vue.use 会自动阻止注册相同插件屡次,届时只会注册一次该插件。

Vue.js 官方提供的一些插件 (例如 vue-router) 在检测到 Vue 是可访问的全局变量时会自动调用 Vue.use()。

然而在例如 CommonJS 的模块环境中,你应该始终显式地调用 Vue.use():

// 用 Browserify 或 webpack 提供的 CommonJS 模块环境时
var Vue = require('vue')
var VueRouter = require('vue-router')
// 不要忘了调用此方法
Vue.use(VueRouter)

本章已完结 (待续 ……)

文章来自 : 搜狗搜到你
                        
                        我的网站 :huai.ye2012vip@qq.com
相关文章
相关标签/搜索