這篇文章主要介紹了關於自製vue組件通信插件之用mixin寫插件,有著一定的參考價值,現在分享給大家,有需要的朋友可以參考一下
這個項目雖然是szpoppy的個人項目,但是在szpoppy公司內是在大面積使用的,一直由szpoppy維護;我個人和szpoppy在一起工作接近一年,經常看他的源代碼,從他身上學到非常多。
本文架構:
1.比較VUEX
2.外掛程式已有功能
3.外掛程式如何使用
4.demo示範
5.具體使用方式
6.原始碼解析,教你如何用mixin寫vue外掛(一看就會,通俗易懂)
'vue-unicom'語法直觀,使用起來基本上沒有學習成本;這個外掛可以大大簡化你的專案
規模的應用。
2.已有功能
#發送指令到還沒初始化的分組元件;
發送指令到還沒初始化的id元件;
npm install vue-unicom
import VueUnicom from 'vue-unicom' // 非 cli 也必须 install一下 Vue.use(VueUnicom, { // 制定名称, 默认为 unicom unicom: 'unicom', // 定制分组使用名称 默认为 unicom + 'Name' unicomName: 'unicomName', // 定制id使用名称 默认为 unicom + 'Id' unicomId: 'unicomId' })
詳情存取這個github的readme位址
// 1. 下载 git clone https://github.com/szpoppy/vue-unicom.git // 2. cd vue-unicom //3.运行demo,可以直接打开src目录下的index.html(推荐这种更方便的方法)也可以用gulp运行 // 4.‘vue-unicom’源代码在‘/src/lib/unicom.js’
元件編寫範例如下,下面進一步詳細介紹
Vue.component('ca', { template: '<p></p><p>text:{{text}}#{{unicomId}}</p><p>msg: {{msg}}</p>', unicomName: 'a', unicom: { message: function(sender, text){ this.msg = text } }, data: function(){ return { text: 'component - ca', msg: 'a' } }, mounted(){ console.log(' a component ',this) } })
元件呼叫範例如下
<p> <ca></ca> <ca></ca> <cb1></cb1> <cb2></cb2> <cc></cc> </p><hr> <cbtn></cbtn>
{ // Vue中增加 增加unicom参数 // 这里的unicom,指 上面传入的参数 unicom: { // instruct1:通讯指令 // sender:发送指令者($vm) // args:指令发出者附带参数 // 参数如果为对象,是引用类型,如果需要设置,请深度克隆一遍 instruct1 (sender, ...args) { // .... this 为当前组件 }, instruct2 (sender, ...args) { } } }
{ // Vue中增加 增加unicomName参数 // 指定分组 属于 group, 所有实例,都属于这个分组 unicomName: 'group' }
{ // 组件可以加入多个分组 unicomName: ['group1', 'group2'] }
<!-- 加入group分组 --> <component></component>
<!-- 指定$vm的 id 为 id1 --> <component></component>
{ methods:{ method1 () { // 发送 instruct1 指令,参数为 1, 2 this.$unicom('instruct1', 1, 2) } } }
instruct1@group (傳送至指定分組)instruct1#id1 (傳送至指定元件)
@group (取得指定分組元件)
##id1 (取得指定元件)
指令使用~ 打頭
~instruct1 ##指令使用~ 打頭~instruct1 ##指令使用~ ,直到包含有instruct1指令的元件出現)~instruct1#id1 (指令延遲發送,直到出現命名id1的元件)~instruct1@group (指令延遲發送,直到出現分組命名group的元件)
5.9 元件監聽
元件監聽使用, 指令使用~ 打頭, 第二個參數為callback~@group (監聽分組groupgroup的元件出現)~ (子監聽任何新出現的元件)~#id1 (監聽命名id1的元件出現)
6.1 用ximin做插件,prototype定義全域函數(插件機制的重點)
建議先閱讀vue插件機制https: //cn.vuejs.org/v2/guide/plugins.html
拿到原始碼'unicom.js'第一步,先用編譯器把所有的方法都收起來,除了install函式
function install(vue, {
name = 'unicom',
idName,
groupName
} = {}) {
//简单几行代码判断是否安装过
// 添加原型方法,全局组件调用
vue.prototype['$' + name] = unicomQuery
// unicomIdName = 'unicomId' id作为唯一标识
unicomIdName = idName || (name + 'Id')
// unicomGroupName = 'unicomName' 分组
unicomGroupName = groupName || (name + 'Name')
// 全局混入
vue.mixin({
props:
watch:
beforeCreate(){}
created(){},
destroyed(){}
})
// 自定义属性合并策略
let merge = vue.config.optionMergeStrategies
// 改变了自定义属性unicomName和unicom的合并策略
merge[name] = merge[unicomGroupName] = function (parentVal, childVal){
//...
}
}
利用vue原型链挂载一个全局的‘$unicom’方法,可以在全局内调用,也可以作为组件内节点click时的方法,click直接发送数据
<button>发送指令 message</button> <button>发送指令 message@a</button>
methods:{ sendData(){ this.$unicom('message@c', '测试数据') } },
如不了解,建议阅读https://cn.vuejs.org/v2/guide/mixins.html
插件逻辑处理的重点部分:全局混入mixin
props:这个部分非常简单,就是为了让每个组件都能在组件调用时传递变量‘unicom-id’或者‘unicom-name’(一般是静态变量)
watch:这个部分主要就是当组件调用时‘unicom-id’或者‘unicom-name’传递过来的是动态变量对其进行实时监听
beforeCreate:在组件已解析但未加载时,利用‘this.$options’去获取自定义‘unicom’属性,然后在每一个组件内加入事件机制;最后利用Map集合以组件vm作为key,将该组件的分组和通信函数合并的对象作为value存起来
created:在组件已经解析和载入到dom结构之后,从Map集合中获取当前组件的分组和通信函数信息,判断是否有其它组件在当前组件未创建之前给它发送了数据,如果有,响应该延迟发送的数据
destroyed:组件销毁逻辑
如不了解,建议阅读vue中的optionMergeStrategies
这个部分看起来简单的几行,其实却是个插件开发过程中比较重点的部分
如何理解这个‘optionMergeStrategies’呢?该组件主要针对自定义option属性的混合;官方解释是:’当组件和混入对象含有同名选项时,这些选项将以恰当的方式混合‘。
肯定很多人还是不明白,其实说实话我也不算明白,但是我简单解释一下:
这个东西具体的使用你其实可以仔细的看看vuex对这个的使用和‘vue-unicom’中optionMergeStrategies的使用
官网的这句‘当组件和混入对象含有同名选项时,这些选项将以恰当的方式混合’是很透彻的在讲这个东西的概念
在‘vue-unicom’插件中optionMergeStrategies有两个用处,一般情况下主要是将‘unicom-id’和‘vue-unicom’从原本数据格式变成数组;但是,如果当前组件或者vue全局被混入了和我们插件自定义option属性同名的变量,默认的合并策略是后面定义的option属性覆盖前面的,但是我们这里对合并策略进行了重写,就可以保证当前组件上所有的‘unicom-id’或者‘vue-unicom’属性都被push到一个数组中并挂载在当前组件上
简单理解它在当前插件的作用:子组件和上层组件有相同option属性时,让子组件正确合并上层组件的自定义属性
我们可以很肯定一点:vue本身并没有这两个option属性,甚至很可能很多人也从来没有自己在组件声明时自定义options属性
如果你没有试过,也没有关系,看了本篇文章之后你就知道了
为什么我们要自定义option属性呢?这两个属性的作用很明确,‘unicomName’是做分组声明的,‘unicom’是做通信函数的;然后在mixin的各个声明周期再利用‘this.$options’获取自定义option属性进行进一步的逻辑处理,并声明optionMergeStrategies合并策略
利用map集合以组件vm为单位存储该组件的分组和通信函数
每次存通信函数、分组的时候都会把对应的vm示例存储下来,所以要找通信函数或者对应分组就非常简单
这个组件较我一开始使用已经经过了一次对代码更加直观的改进,个人觉得非常值得大家阅读和使用
以上就是本文的全部内容,希望对大家的学习有所帮助,更多相关内容请关注PHP中文网!
相关推荐:
以上是自製vue組件通訊插件之用mixin寫入插件的詳細內容。更多資訊請關注PHP中文網其他相關文章!