一、子应用互相访问

1、背景

(1)未来可能需要做不同子应用菜单的合并,如在bi应用下的侧边栏或者别的地方,需要跳转到数据治理的数仓主题里,或者涉及到子应用值改变,其他应用也需要使用;

(2)a标签跳转会使整个页面重新刷新,原来的状态都会丢失掉;

(3)用子应用router的history跳转会带上子应用的base,导致路由跳转404。这就造成使用微应用 router 的方法无法跳回主应用,也就无法直接跳到其他微应用。

2、解决方法

(1) 通过history.pushState()方式跳转。 //不刷新页面,更改页面的url

  • state:一个与指定网址相关的状态对象,popstate事件触发时,该对象会传入回调函数。如果不需要这个对象,此处可以填null。
  • title:新页面的标题,但是所有浏览器目前都忽略这个值,因此这里可以填null。
  • url:新的网址,必须与当前页面处在同一个域。浏览器的地址栏将显示这个网址。

注意:该方式使用的前提是路由系统底层用的是 history 模式。

示例如下:

  • 在该A子应用下,定义侧边栏时,自定义跳转到B应用的菜单栏,应用isAnotherProject加以标识;定义字段记录子应用的对应path记录。

  • 在点击侧边栏跳转时,做出相应判断后,通过window.history.pushState(null,'',path)跳转。

(2) 将主应用的路由实例传递给子应用,子应用使用主应用的路由实例进行跳转。

API——>registerMicroApps(apps, lifeCycles) 注册微应用配置信息。

  • apps - Array<RegistrableApp> - 必选,微应用的一些注册信息
  • lifeCycles - LifeCycles - 可选,全局的微应用生命周期钩子

示例如下:

  • 在主应用中的registerAppConfig文件中注册微应用配置信息,在有微应用间相互跳转的相关配置信息里,将路由实例传递通过props传递进去。

  • 在子应用的main.js的mount函数里将接收到的 props 参数内的函数挂在 vue 原型上方便使用,你也可以在其他导出的生命周期函数内得到 props 并按照你的设想去处理。

  • 挂载成功后,可以在该子应用内的需要进行跨子应用跳转时使用父组件的router实例,直接进行相应的跳转、路由传参。

二、子应用到主应用

1. 解决方法

(1) 通过history.pushState()方式跳转。

(2) 通过主应用路由实例跳转,实践发现会出现主应用css未加载的情况。

现象:

从子项目页面跳转到主项目自身的页面时,主项目页面的 css 未加载的 bug。

原因:

在子项目跳转到父项目时,子项目的卸载需要一点点的时间,在这段时间内,父项目加载了,插入了 css,但是被子项目的 css 沙箱记录了,然后被移除了。父项目的事件监听也是一样的,所以需要在子项目卸载完成之后再跳转。本来考虑在路由钩子函数里面判断下,子项目是否卸载完成,卸载完成再跳转路由,然而路由不跳转,子项目根本不会卸载。

解决办法:

先复制一下 HTMLHeadElement.prototype.appendChild 和 window.addEventListener ,路由钩子函数 beforeEach 中判断一下,如果当前路由是子项目,并且去的路由是父项目的,则还原这两个对象。

const parentRoute = ['/home']; //主应用路由
const isParentRoute = (path: string) => parentRoute.some(item => path.startsWith(item));
const rawAppendChild = HTMLHeadElement.prototype.appendChild;
const rawAddEventListener = window.addEventListener;
router.beforeEach((to, from, next) => {
    // 从子项目跳转到主项目
    //如果当前路由是子项目,并且去的路由是父项目的,则还原这两个对象
    if (!isParentRoute(from.path) && isParentRoute(to.path)) {
        HTMLHeadElement.prototype.appendChild = rawAppendChild;
        window.addEventListener = rawAddEventListener;
    }
    console.log(isParentRoute(from.path), isParentRoute(to.path), !isParentRoute(from.path) && isParentRoute(to.path));

这样就可以正常在微应用里通过父应用的路由实例进行跳转了。

const parentRoute = ['/home']; //主应用路由
const isParentRoute = (path: string) => parentRoute.some(item => path.startsWith(item));
const rawAppendChild = HTMLHeadElement.prototype.appendChild;
const rawAddEventListener = window.addEventListener;
router.beforeEach((to, from, next) => {
    // 从子项目跳转到主项目
    //如果当前路由是子项目,并且去的路由是父项目的,则还原这两个对象
    if (!isParentRoute(from.path) && isParentRoute(to.path)) {
        HTMLHeadElement.prototype.appendChild = rawAppendChild;
        window.addEventListener = rawAddEventListener;
    }
    console.log(isParentRoute(from.path), isParentRoute(to.path), !isParentRoute(from.path) && isParentRoute(to.path));

三、以上两种方案比较(加之前使用的url跳转方式)

window.history.pushState

将主应用路由实例注入子应用

使用 window.location.href 等方法进行 url 跳转跳转

速率

页面切换速率明显加快

页面切换速率明显加快

页面首次加载渲染时间很长

页面效果

无白屏情况出现

无白屏情况

首次加载,会出现一段时间的白屏,体验不佳

实现复杂程度

轻量级

实现较为复杂(考虑子应用跳转主应用会出现主应用样式未加载的bug,需要额外添加代码处理该情况)

-------------------------

利弊

  • 要求各个应用路由系统都使用history模式;
  • 切换时,仅改变url,不会导致页面刷新。
  • 正式方案,衔接各个应用自然;
  • 会出现主项目页面的 css 未加载的 bug。
  • 出现白屏;
  • 首次加载缓慢。

四、总结

结合项目现状,实现复杂程度,考虑使用window.history.pushState该方式跳转更加合理便捷。

???随记:
调主应用的路由,主应用再去匹配分发到子应用路由
跳转的时候先判断是否在qiankun环境下,如果是qiankun环境下,调用h5自带的history.pushState()跳转
如果是子应用独立开发部署,就使用路由跳转。
import { history as umiHistory } from 'umi';

export const qiankunJump = (url:string, name="页面名称",params=null) => {
window.POWERED_BY_QIANKUN ? history.pushState(params, name, url) : umiHistory.push(url);
}

qiankunJump('/routePath')

五、如果我的路由模式是hash,子应用之间该如何跳转?

对于使用hash模式的路由,在子应用程序之间进行跳转时,可以使用`window.location.hash`属性来修改URL的hash部分,从而实现跳转。这种方式可以避免页面的白屏问题。

以下是一个示例,展示了如何在子应用程序中使用hash模式进行跳转:

// 在子应用程序中进行hash路由跳转
window.location.hash = '#目标路由';

通过修改`window.location.hash`属性,您可以在当前子应用程序中进行hash路由的跳转。

请注意,当您在子应用程序之间进行hash路由跳转时,qiankun会自动感知到URL的变化,并加载相应的子应用程序。这样可以保持应用程序的微前端特性,并且不会导致页面的白屏。
有网友反馈以上的hash模式跳转这个方法不行,具体参考qiankun github里的方法:


const event = new Event('hashchange')
window.dispatchEvent(event)

Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐