什么是微前端?
微前端是指存在于浏览器中的微服务。
本文主要通过对微前端框架single-spa的基座应用加载子应用的single-spa-vue函数库进行分析,通过代码维度分析让大家了解在single-spa加载子应用的时候都做了哪些事情。如何通过优化single-spa-vue函数库保持子应用的状态。
由于是在代码维度进行分析,要求读者对single-spa有一定的了解,阅读效果会更好。
基座应用中配置的加载子应用配置,在配置子应用对象的app方法中会把子应用chunk-vendors.js、app.js插入到页面,并且执行chunk-vendors.js、app.js两个子应用依赖的js。
app方法执行结束以后,子应用依赖的js插入页面以后的dom结构。
由上面app方法的执行过程,我们可以看出基座应用加载子应用,和vue框架打包后加载js资源的方式类似。那么为什么只需要加载子应用的app.js和chunk-vendors.js就可以把子应用渲染到页面上面。下面我们再来看看子应用的入口文件main.js方法中是如何进行配置的。
在子应用main.js中我们可以看到,把常规的配置1替换为配置2的格式。
在配置2中我们会把当前vue的配置传给single-spa-vue函数库中。包括el、render方法、Vue对象。通过singleSpaVue的包装,返回single-spa生命周期方法bootstrap、mount、unmount。
也就是说基座应用在加载子应用的时候就是通过single-spa-vue函数的处理,生成了single-spa的各个生命周期,给基座应用在加载子应用的时候调用。
下面我们来看看single-spa-vue究竟是如何生成各种生命周期函数的。
single-spa-vue函数库可以帮助我们来生成加载子应用的生命周期。你可以通过下面链接:single-spa-vue GIT地址,下载single-spa-vue函数库的源码。
single-spa-vue的源码非常简单,只有几个生成single-spa生命周期的函数。
下面我们详细介绍一下这几个方法的作用和实现。
single-spa-vue中提供的singleSpaVue方法会接收userOpts配置信息,配置信息会和默认的配置项defaultOpts合并以后再进行进行后续处理。
对于默认的配置项会有下面这几项,这里只介绍一下必填项,appOptions、Vue/createApp。其中的template在并没有在single-spa-vue中被用到,但是在single-spa-html中有使用到。
// 默认配置项列表
const defaultOpts = {
// required opts
appOptions: null,
template: null,
// sometimes require opts
Vue: null,
createApp: null,
handleInstance: null
}
1)appOptions配置项介绍
2)Vue/createApp配置项介绍
Vue/createApp配置项是用来生成vue实例的,single-spa-vue函数库可以通过传入的Vue对象在mount方法中来生成vue实例。也可以传入createApp方法,由子应用在createApp方法中返回vue实例。
下面我们会在生命周期生成方法中看到这些配置项的作用
singleSpaVue方法会对入参先进行下列有效性校验,具体校验的内容有一下四项。
有效性校验通过以后,会调用bootstrap、mount、unmount、update方法用来分别生成single-spa加载子应用的生命周期函数。
下面详细介绍一下各个生命周期函数是如何生成的。
引导函数bootstrap,当应用内容首次挂载到页面前调用。
bootstrap函数,会先判断一下是否在配置项中存在loadRootComponent。配置项loadRootComponent笔者理解是可以用来加载当前子应用依赖的父级应用或者其他的依赖资源。
比如A页面依赖B组件,那在加载A页面的时候可以loadRootComponent方法中把B组件的静态资源加载下来,并且渲染到页面上,A页面就可以直接使用B组件中提供的一些资源或者dom。
如果未配置loadRootComponent,则直接返回,不做任何处理。
在子应用每次被挂载到页面上的时候,single-spa会执行mount生命周期函数,single-spa-vue在mount函数中用来初始化子应用的vue实例,并且把实例挂载到页面上。
mount函数会接收三个参数,分别是singleSpaVue传入的参数opts,single-spa-vue当前全局挂载的子应用实例列表mountedInstances,在基座应用中注册的当前子应用的single-spa实例props
props入参接收的数据,这里只用到了props的name属性,用来标识当前挂载的子应用。
在mount方法中主要做了以下几件事
1)格式化应用配置项appOptions
mount方法中会通过resolveAppOptions方法来格式化应用的配置项appOptions。
在resolveAppOptions方法来中如果appOptions是一个方法的话,则执行方法,并且传递基座应用通过customProps参数传入的参数props。
子应用可以在appOptions方法中获取父应用传递的参数、根据父应用的状态做不同的处理等。
2)初始化子应用需要挂载的DOM对象。
初始化dom的配置和方法比较多,会从很多个配置项中来获取el,代码比较简单,这里就不赘述了。只列出来取值的优先级供大家参考。
appOptions.el > props.domElement > props.name
dom节点被格式化完成以后,下面就开始把页面挂载到dom上面。
3)创建vue示例,并且挂载到页面上
在挂载页面之前会有一个配置项:replaceMode,replaceMode配置项是用来标识是否需要替换el节点下的内容。默认replaceMode为false是会在el节点下面新建一个class为single-spa-container的空白div来保存子应用。
以demo中的代码为例:
默认replaceMode为false的情况下,基座中的的内容和vue1中的内容会并存。如下图:
如果把replaceMode改为true的情况下,会发现基座中的内容会被vue1中的内容覆盖掉。
如下图:
设置挂载方式以后,就开始把子应用真正挂载到dom上面。
这里支持两种挂载方式,一种是使用vue3的createApp方式挂载,一种是使用vue2的new Vue方式进行挂载。这里的挂载方式其实和我们在使用vue挂载到dom方式的配置是一样的。
通过上面的步骤,此时子应用就被挂载到了html的页面中的dom上了。
当调用parcel.update()会触发update方法,笔者由于并没有用的高级特性parcel,在此处不再做过多介绍。
当页面url发生变化的时候,离开子应用页面路由的时候会触发unmount方法。
在unmount方法中主要做的事情有:
执行unmount操作以后子应用的数据和dom就会被清除干净。
以上就是single-spa官方提供的single-spa-vue函数库来挂载子应用的全部流程。通过上面的分析,我们发现single-spa-vue函数库会通过调用singleSpaVue方法返回一个包含bootstrap、mount、update、unmount四个方法的对象。在基座应用加载子应用的生命周期会执行对应的方法,通过执行方法把子应用挂载到基座应用或者从基座应用销毁子应用。
通过single-spa-vue中加载子应用的过程,single-spa把各个子应用组装成一个复杂的应用,在用户无感的情况下对各个子应用进行分别治理。
single-spa在加载子应用的时候,除了vue的版本之外,还有其他的版本,但是加载的思路类似,都是在函数库中来把子应用加载到html中,此处不再介绍其他类型的加载。
single-spa其他加载子应用方式:single-spa-react、single-spa-html
在实际开发的过程中笔者遇到有些页面需要使用vue中的keep-alive来保留状态,在页面切换的过程中虽然页面被销毁但是页面状态需要在保留,但是我们在分析single-spa-vue的unmount方法实现的时候发现,如果页面切换,子应用和vue实例被销毁,此时子应用中的keep-alive是没有生效的。
如下图:
当在input中输入内容以后,传统的spa项目可以通过keep-alive来记录状态,当页面路由切换以后,再切回来,仍然保持状态。但是如果直接使用single-spa-vue,当子应用触发unmount的时候input中的输入内容1111会被清空。针对这种情况,笔者对single-spa-vue类库进行了一些改造。
改造内容如下:
在single-spa-vue配置项中增加了一个配置项,根据配置项中是否存在isKeepAlive配置项,来判断把当前的dom隐藏掉,还是删除。这样当子应用unmount方法触发的时候,子应用并未被删除,而是仍然保留。
同时笔者对vue的route配置也进行了一些优化,当页面不存在的时候,此时会把子应用中的一个空组件挂载到dom上面,避免虽然页面被隐藏掉,但是dom仍然在html中,导致页面dom过多。
在single-spa-vue配置项中调用mount方法挂载子应用的时候,会判断当前子应用是否存在,如果子应用存在则直接把子页面显示出来,由于子应用并未被销毁,此时子应用中的keep-alive就会一直生效,并且保存页面的状态。
通过对single-spa-vue类库的mount、unmount方法的优化,用户在使用页面的时候真正和使用vue那样流畅,并且可以保持页面状态,提升用户的体验。