当展示老页面时,把这个 Container
高度设为 0
,要展示新页面时,再把 Container
高度自动撑开。
// micro-app-container
这样一来,当进入老项目时,这个 Container
自动被 mounted 后就会地去加载子应用了。当在切换新页面时,本质上是在子应用里做路由切换,而不是从 A 应用切换到 B 应用了。
子应用的布局
由于新的项目(子应用)里的页面要供给老项目(主应用)来使用的,所以子应用也应该有两套布局:
第一套标准的管理后台布局,有 Sider
,Header
还有 Content
,另一套侧作为子应用时,只展示 Content
部分的布局。
// 单独运行时的布局
export const StandaloneLayout: FC = () => {
return (
)
}
// 作为子应用时的布局
export const MicroAppLayout = () => {
return (
)
}
单独运行时的布局
作为微应用时的布局
最后通过 window.__POWERED_BY_QIANKUN__
就可以切换不同的布局了。
import { StandaloneLayout, MicroAppLayout } from “./components/Layout”;
const Layout = window.POWERED_BY_QIANKUN ? MicroAppLayout : StandaloneLayout;
function App() {
return (
);
}
样式冲突
qiankun 是默认开启 JS 隔离(沙箱),关闭 CSS 样式隔离的。为什么这么做呢?因为 CSS 的隔离是不能无脑做去做的,下面来讲讲这方面的问题。
qiankun 一共提供了两种 CSS 隔离方法(沙箱):严格沙箱 以及 实验性沙箱。
严格沙箱
开启代码:
start({
sandbox: {
strictStyleIsolation: true,
}
})
严格沙箱主要通过 ShadowDOM
来实现 CSS 样式隔离,效果是当子应用被挂在到 ShadowDOM
上,主子应用的样式 完完全全 地被隔离,无法互相影响。你说:这不是很好么?No No No。
这种沙箱的优点也成为了它自己的缺点:除了样式的硬隔离,DOM 元素也直接硬隔离了,导致子应用的一些 Modal
、Popover
、Drawer
组件会因为找不到主应用的 body
而丢失,甚至跑到整个屏幕之外。
还记得我刚说主应用和子应用都用了 ant-design 么?ant-design 的 Modal
、Popover``Drawer
的实现方式就是要挂在到 document.body
上的,这么一隔离,它们一挂在整个元素起飞了。
实验性沙箱
开启代码:
start({
sandbox: {
experimentalStyleIsolation: true,
}
})
这种沙箱实现方式就是给子应用的样式加后缀标签,有点像 Vue 里的 scoped
,通过名字来做样式 “软隔离”,比如像这样:
其实这种方式已经很好地做了样式隔离,但是主应用里经常有人喜欢写 !important
来覆盖 ant-design 的组件原样式:
.ant-xxx {
color: white: !important;
}
而 !importnant
的优先级是最高的,如果微应用也用了这个 .ant-xxx
类,就很容易被主应用的样式影响了。所以在加载微应用时,还需要处理 ant-design 之间的样式冲突问题。
ant-design 样式冲突
ant-design 提供了一个非常好的类名前缀功能:用 prefixCls
来做样式隔离,我自然也用上了:
// 自定义前缀
const prefixCls = ‘cmsAnt’;
// 设置 Modal、Message、Notification rootPrefixCls
ConfigProvider.config({
prefixCls,
})
// 渲染
function render(props: any) {
const { container, state, commit, dispatch } = props;
const value = { state, commit, dispatch };
const root = (
<MicroAppContext.Provider value={value}>
</MicroAppContext.Provider>
);
ReactDOM.render(root, container
? container.querySelector(‘#root’)
: document.querySelector(‘#root’));
}
@ant-prefix: cmsAnt; // 引入来改变全局变量值
但是不知道为什么,在 less 文件中改了 ant-prefix
变量后,ant-design-pro 的样式还是老样子,有的组件样式改变了,有的没变化。
最后,我是通过 less-loader
的 modifyVars
在打包时来更新全局的 ant-prefix
less 变量才搞定的:
var webpackConfig = {
test: /.(less)$/,
use: [
…
{
loader: ‘less-loader’,
options: {
lessOptions: {
modifyVars: {
‘ant-prefix’: ‘cmsAnt’
},
sourceMap: true,
javascriptEnabled: true,
}
}
}
]
}
具体 Issue 看 Issue: ant-design 改了 prefixCls 后 ant-design-pro 不生效。
主子应用状态管理
老项目(主应用)用到了 vuex 全局状态管理,所以新项目页面(子应用)里有时需要更改主应用里的状态,这里我用了 qiankun 的 globalState 来处理。
首先在 Container 里创建了 globalActions
,再监听 vuex 状态变更,每次变更都通知子应用,同时把 vuex 的 commit
和 dispatch
函数传给子应用:
import {initGlobalState, registerMicroApps, start} from ‘qiankun’
const globalActions = initGlobalState({
state: {},
commit: null,
dispatch: null,
});
export default {
name: “Container”,
props: {
visible: {
type: Boolean,
defaultValue: false,
}
},
mounted() {
const { dispatch, commit, state } = this.$store;
registerMicroApps([
{
name: ‘microReactApp’,
entry: ‘//localhost:3000’,
container: ‘#micro-app-container’,
activeRule: ‘/#/micro-react-app’,
// 初始化时就传入主应用的状态和 commit, dispatch
props: {
state,
dispatch,
commit,
}
},
])
start()
// vuex 的 store 变更后再次传入主应用的状态和 commit, dispatch
this.$store.watch((state) => {
console.log(‘state’, state);
globalActions.setGlobalState({
state,
commit,
dispatch
});
})
},
}
子应用里接收主应用传来的 state
,commit
以及 dispatch
函数,同时新起一个 Context,把这些东西都放到 MicroAppContext
里。(Redux 因为不支持存放函数这种 nonserializable 的值,所以只能先存到 Context 里)
// 渲染
function render(props: any) {
const { container, state, commit, dispatch } = props;
const value = { state, commit, dispatch };
const root = (
<MicroAppContext.Provider value={value}>
</MicroAppContext.Provider>
);
ReactDOM.render(root, container
? container.querySelector(‘#root’)
: document.querySelector(‘#root’));
}
// mount 时监听 globalState,只要一改再次渲染 App
export async function mount(props: any) {
console.log(‘[micro-react-app] mount’, props);
props.onGlobalStateChange((state: any) => {
console.log(‘[micro-react-app] vuex 状态更新’)
render(state);
})
render(props);
}
这样一来,子应用也可以通过 commit
,和 dispatch
来更改主应用的值了。
const OrderList: FC = () => {
const { state, commit } = useContext(MicroAppContext);
return (
【微应用】订单列表
常用的JavaScript设计模式
-
单体模式
-
工厂模式
-
例模式
函数
-
函数的定义
-
局部变量和全局变量
-
返回值
-
匿名函数
-
自运行函数
-
闭包