MicroApp初步使用

MicroApp 借鑒了 WebComponent 的思想账嚎,通過(guò) CustomElement 結(jié)合自定義的 ShadowDom芍殖,將微前端封裝成一個(gè)類 WebComponent 組件咕缎,從而實(shí)現(xiàn)微前端的組件化渲染

基應(yīng)用修改

安裝插件

npm install @micro-zoe/micro-app --save

引入依賴

import microApp from '@micro-zoe/micro-app'
// 可以傳入一個(gè)對(duì)象進(jìn)行全局配置
microApp.start()

添加組件

<template>
  <div>
    <micro-app 
        name='child' 
        url='http://localhost:3000/' 
        baseroute='/my-page'></micro-app>
  </div>
</template>
  • name 應(yīng)用名稱黍衙,每個(gè)應(yīng)用的值全局唯一泥畅;必傳

  • url 應(yīng)用地址,可以在地址欄訪問(wèn)到琅翻;必傳

  • baseroute 子應(yīng)用的基礎(chǔ)路由
    地址拼接方法

    let href = window.location.href, hrefs = href.split(baseroute)
    let realUrl = `${url}${baseroute}${hrefs.length === 2 ? hrefs[1] : ''}`
    

    例:地址欄值為 http://localhost:80/my-page/home 時(shí)位仁,該子應(yīng)用訪問(wèn)的地址為 http://localhost:3000/home

  • destory 卸載時(shí)是否強(qiáng)制刪除緩存資源,子應(yīng)用在卸載后會(huì)清空緩存資源方椎,再次渲染時(shí)重新請(qǐng)求數(shù)據(jù)

子應(yīng)用修改

靜態(tài)資源路徑

設(shè)置 webpack 的公共路徑 publicPath

__webpack_public_path__ = window.__MICRO_APP_PUBLIC_PATH__ || '/'

項(xiàng)目入口文件

let app

/** 掛載函數(shù) */
function mount () {
    app = new Vue({
        el: '#app',
        template: '<App/>',
        components: { App },
    })
}

/** 卸載函數(shù) */
function unmount () {
    app.$destroy()
    app.$el.innerHTML = ''
    app = null
}

// 微前端環(huán)境下聂抢,注冊(cè)mount和unmount方法
if (window.__MICRO_APP_ENVIRONMENT__)
    window[`micro-app-${window.__MICRO_APP_NAME__}`] = { mount, unmount }
else
    mount()

預(yù)加載

子應(yīng)用

通過(guò) microApp.start 配置項(xiàng)的 preFetchApps 屬性設(shè)置子應(yīng)用的預(yù)加載,或者通過(guò) microApp.preFetch 方法設(shè)置

/** 子應(yīng)用列表 */
const apps = [{ name: 'child', url: 'http://localhost:3000' }]

// 方式一
microApp.start({ preFetchApps: apps })
// microApp.start({ preFetchApps: () => apps })

// 方式二
microApp.preFetch(apps)
// microApp.preFetch(() => apps)

靜態(tài)資源

  • 資源共享
    通過(guò) microApp.start 配置項(xiàng)的 globalAssets 屬性設(shè)置全局共享資源棠众,子應(yīng)用加載相同地址的資源時(shí)琳疏,會(huì)直接從緩存中讀取數(shù)據(jù)

    /** 靜態(tài)資源列表 */
    const assets = { js: ['/static/js/vendor.dll.js'], css: [] }
    
    microApp.start({ globalAssets: assets })
    

    通過(guò)在打包后的 link、script 標(biāo)簽上設(shè)置 global 屬性,micro-app 會(huì)在第一次加載該文件后放入公共緩存空盼,其他應(yīng)用加載相同地址的資源時(shí)书幕,會(huì)直接從緩存中讀取數(shù)據(jù)

    <link rel="stylesheet" href="xx.css" global>
    <script src="xx.js" global></script>
    
  • 資源過(guò)濾 exclude
    通過(guò)在打包后的 link、script我注、style 標(biāo)簽上設(shè)置 exclude 屬性過(guò)濾這些資源加載按咒,micro-app 會(huì)刪除帶有 exclude 屬性的元素;和資源共享搭配使用提升子應(yīng)用的渲染速度

    <link rel="stylesheet" href="xx.css" exclude>
    <script src="xx.js" exclude></script>
    <style exclude></style>
    

組件通信

基應(yīng)用向子應(yīng)用傳遞

基應(yīng)用通過(guò) data 屬性向子應(yīng)用傳遞數(shù)據(jù)但骨,子應(yīng)用通過(guò) window.microApp.addDataListener 添加數(shù)據(jù)監(jiān)聽(tīng)方法

<!--基應(yīng)用文件-->
<template>
    <micro-app :data="micro.data"></micro-app>
</template>

<script>
export default {
    data() {
        return {
            micro: { 
                data: { name: '' } 
            }
        }
    }
}
</script>


<!--子應(yīng)用文件-->
<template>
    ...
</template>

<script>
export default {
    methods: {
        dataListener(data) {
            console.log(data)
        }
    }
    , created () {
        /** 綁定數(shù)據(jù)監(jiān)聽(tīng)事件 */
    window.microApp && window.microApp.addDataListener(this.dataListener)
    }
    , destroyed () {
    /** 移除數(shù)據(jù)監(jiān)聽(tīng)事件 */
    window.microApp && window.microApp.removeDataListener(this.dataListener)
    }
}
</script>

子應(yīng)用向基應(yīng)用傳遞

子應(yīng)用通過(guò) window.microApp.dispatch 向外拋出一個(gè)數(shù)據(jù)励七,基應(yīng)用通過(guò) datachange 事件接收子應(yīng)用拋出的數(shù)據(jù)

<!--基應(yīng)用文件-->
<template>
    <micro-app @datachange='handleDataChange'></micro-app>
</template>

<script>
export default {
    methods: {
        handleDataChange(event) {
            console.log(event.detail.data)
        }
    }
}
</script>

<!--子應(yīng)用文件-->
<template>
    <div>
        <button @click="send">向基應(yīng)用發(fā)送數(shù)據(jù)</button>
    </div>
</template>

<script>
export default {
    methods: {
        send() {
            window.microApp && window.microApp.dispatch({ message: '子應(yīng)用發(fā)送' })
        }
    }
}
</script>

生命周期函數(shù)

基應(yīng)用定義

基應(yīng)用可以定義 createdbeforemount奔缠、mounted掠抬、unmounterror 五個(gè)生命周期函數(shù)

<template>
    <micro-app
        @created='created'
        @beforemount='beforemount'
        @mounted='mounted'
        @unmount='unmount'
        @error='error'
    ></micro-app>
</template>

<script>
export default {
    methods: {
        created () {
            /**標(biāo)簽初始化后校哎,加載資源前觸發(fā) */
            console.log(`created`)
        }
        , beforemount () {
            /**加載資源完成后两波,開(kāi)始渲染之前觸發(fā) */
            console.log(`beforemount`)
        }
        , mounted () {
            /**子應(yīng)用渲染結(jié)束后觸發(fā) */
            console.log(`mounted`)
        }
        , unmount () {
            /**子應(yīng)用卸載時(shí)觸發(fā) */
            console.log(`unmount`)
        }
        , error () { 
            /**子應(yīng)用渲染出錯(cuò)時(shí)觸發(fā),只有會(huì)導(dǎo)致渲染終止的錯(cuò)誤才會(huì)觸發(fā)此生命周期 */
            console.log(`error`)
        }
    }
}
</script>

子應(yīng)用定義

子應(yīng)用可以定義 mount闷哆,unmount 兩個(gè)生命周期函數(shù)

window[`micro-app-${window.__MICRO_APP_NAME__}`] = { mount, unmount }

執(zhí)行順序

  • 組件加載
    created腰奋、beforemountmount(child)抱怔、mounted

  • 組件卸載
    unmount(child)劣坊、unmount

  • 組件異常
    error

環(huán)境變量

  • window.__MICRO_APP_BASE_ROUTE__
    由基應(yīng)用下發(fā)的路由前綴,即 <micro-app> 標(biāo)簽的 baseroute 值屈留,用于區(qū)分子路由

  • window.__MICRO_APP_PUBLIC_PATH__
    在子應(yīng)用中通過(guò)獲取應(yīng)用地址局冰,即 <micro-app> 標(biāo)簽的 url 值

  • window.__MICRO_APP_NAME__
    在子應(yīng)用中通過(guò)獲取應(yīng)用的 name 值,即 <micro-app> 標(biāo)簽的name值灌危。

  • window.__MICRO_APP_ENVIRONMENT__
    判斷子應(yīng)用是否在微前端環(huán)境中

  • window.__MICRO_APP_BASE_APPLICATION__
    判斷應(yīng)用是否為基應(yīng)用康二,在 microApp.start() 后有效

原文鏈接:MicroApp初步使用

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市勇蝙,隨后出現(xiàn)的幾起案子沫勿,更是在濱河造成了極大的恐慌,老刑警劉巖浅蚪,帶你破解...
    沈念sama閱讀 211,123評(píng)論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件藕帜,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡惜傲,警方通過(guò)查閱死者的電腦和手機(jī)洽故,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,031評(píng)論 2 384
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)盗誊,“玉大人时甚,你說(shuō)我怎么就攤上這事隘弊。” “怎么了荒适?”我有些...
    開(kāi)封第一講書人閱讀 156,723評(píng)論 0 345
  • 文/不壞的土叔 我叫張陵梨熙,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我刀诬,道長(zhǎng)咽扇,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書人閱讀 56,357評(píng)論 1 283
  • 正文 為了忘掉前任陕壹,我火速辦了婚禮质欲,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘糠馆。我一直安慰自己嘶伟,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,412評(píng)論 5 384
  • 文/花漫 我一把揭開(kāi)白布又碌。 她就那樣靜靜地躺著九昧,像睡著了一般。 火紅的嫁衣襯著肌膚如雪毕匀。 梳的紋絲不亂的頭發(fā)上铸鹰,一...
    開(kāi)封第一講書人閱讀 49,760評(píng)論 1 289
  • 那天,我揣著相機(jī)與錄音皂岔,去河邊找鬼掉奄。 笑死,一個(gè)胖子當(dāng)著我的面吹牛凤薛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播诞仓,決...
    沈念sama閱讀 38,904評(píng)論 3 405
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼缤苫,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了墅拭?” 一聲冷哼從身側(cè)響起活玲,我...
    開(kāi)封第一講書人閱讀 37,672評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎谍婉,沒(méi)想到半個(gè)月后舒憾,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 44,118評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡穗熬,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,456評(píng)論 2 325
  • 正文 我和宋清朗相戀三年镀迂,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片唤蔗。...
    茶點(diǎn)故事閱讀 38,599評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡探遵,死狀恐怖窟赏,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情箱季,我是刑警寧澤涯穷,帶...
    沈念sama閱讀 34,264評(píng)論 4 328
  • 正文 年R本政府宣布,位于F島的核電站藏雏,受9級(jí)特大地震影響拷况,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜掘殴,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,857評(píng)論 3 312
  • 文/蒙蒙 一赚瘦、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧杯巨,春花似錦蚤告、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書人閱讀 30,731評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至仍源,卻和暖如春心褐,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背笼踩。 一陣腳步聲響...
    開(kāi)封第一講書人閱讀 31,956評(píng)論 1 264
  • 我被黑心中介騙來(lái)泰國(guó)打工逗爹, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人嚎于。 一個(gè)月前我還...
    沈念sama閱讀 46,286評(píng)論 2 360
  • 正文 我出身青樓掘而,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親于购。 傳聞我的和親對(duì)象是個(gè)殘疾皇子袍睡,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,465評(píng)論 2 348

推薦閱讀更多精彩內(nèi)容