vue任意關係組件通訊與跨組件監聽狀態 vue-communication

大家好!我是木瓜太香!

眾所周知,組件式開發方式給我們帶來了方便,不過也引入了新的問題,組件之間的數據就像被一道無形的牆隔開,如果我們希望臨時讓兩個組件直接通訊,vuex 太巨,而 $emit 又不好維護 provider 不可控 這個時候就該今天的主角 vue-communication 登場了!

vue-communication介紹

  • 他是一個可觀測可調試的vue組件通訊方案
  • 任意關係組件可直接通訊
  • 支援跨組件監聽數據變化
  • 支援發送離線數據

安裝

yarn add vue-communication
// 或者 npm install vue-communication -D

引入

import { $sender, $receiver } "vue-communication";
Vue.prototype.$sender = $sender;
Vue.prototype.$receiver = $receiver;

影片教程

影片地址

用法

基本概念:

該組件暴露兩個主要 API 一個是發送者 $sender 一個是接受者 $receiver,所有的通訊都通過這兩個方法來實現,這裡希望大家將 $sender 理解成發送意圖的發送者,他發送的是意圖,意圖就是希望做一件什麼事情。

意圖類型: dataOnce modifyOnce data modify watch

目前只有以上5種意圖分別涵蓋了:發送數據的一次和多次,修改數據的一次和多次,跨組件監聽數據變化

發送數據:

假如 A 組件只向 B 組件發送一次數據:

A 組件中直接使用 this.$sender("dataOnce-A-B",{d: "我是數據"})

B 組件中在任意時刻(哪怕B都還沒掛載都行,放心食用)使用this.$receiver("dataOnce-A-B") 這個函數返回一個 Promise 對象,直接 .then 接收即可

發送多次就用 this.$sender("data-A-B","我是數據") ,該方法調用多次,對應組件就會多次接收該數據

接收會有變化,由於會多次接收所以無法使用 Promise 來實現,請在參數追加回調this.$receiver("data-A-B",function(data){ // data就是數據 })

注意:

這裡面的 意圖修飾符-組件1-組件2 的格式是強制的,不管你的組件名有多長,你都要完整的給出!下面的修改數據也一樣,對應到 data-A-B 這個案例,其整個字元串可以稱為一個「意圖」,data 叫做意圖修飾符。

接收回執:

我相信大家都明白一個道理,如果委託 A 給 B 送東西,在 A 送到之後不應該默不吭聲的就完了,而是應該告訴你一聲,嘿!你讓我送的東西我已經送到了哦!這就是回執。

需要注意的是回執目前只有在一次性操作中才會有,例如 dataOnce modifyOnce

他們通過 $sender返回的 Promise 對象給出,讓發送者可以知道,我發送的數據什麼時候被接收了

this.$sender("dataOnce-A-B","木瓜太香")
.then(flag => {
    console.log("接受者已經接受到數據了!")
})

修改數據:

A 組件中使用 this.$sender("modifyOnce-A-B","name","木瓜太香") 表示 A 組件要修改 B 組件中的 name 屬性把他變為 木瓜太香

B組件中使用 this.$receiver("modifyOnce-A-B","name") 即可完成修改,注意第二個參數必須傳,這是一個許可,表示你認可 A 組件修改當前組件的 name 屬性,如果你寫錯了或者沒傳那麼許可不成立,這是一個讓數據變動可預測也強迫開發者需要更清楚自己在做什麼的一個實現。

如果你要改 obj 對象下的 name 那麼可以寫成 this.$sender("modifyOnce-A-B","obj.name","木瓜太香")

如果你要修改多次可以參照 data 意圖的示例,使用 modify 意圖修飾符即可,注意,目前修改是沒有回調的,如果你想知道數據什麼時候被修改,可以自己在組件內部監聽。

跨組件監聽數據:

假如 A 組件要監聽 B 組件中的 name 數據變動:

A 組件使用 this.$sender("watch-A-B","person.name",function(nv,ov){ // nv 表示新值 ov 表示舊值 })

B 組件只需要給出一次許可即可: this.$receiver("watch-A-B","person.name")

有前端問題需要討論的可以加我的qun:237871108。也可以通過嗶哩嗶哩搜索木瓜太香找到我。