"use strict";(self.webpackChunkfes_js=self.webpackChunkfes_js||[]).push([[448],{1427:(n,s,a)=>{a.r(s),a.d(s,{data:()=>p});const p={key:"v-3dba8814",path:"/guide/runtime-config.html",title:"运行时配置",lang:"zh-CN",frontmatter:{},excerpt:"",headers:[{level:2,title:"运行时为啥需要配置？",slug:"运行时为啥需要配置",children:[]},{level:2,title:"配置项",slug:"配置项",children:[{level:3,title:"beforeRender",slug:"beforerender",children:[]},{level:3,title:"patchRoutes",slug:"patchroutes",children:[]},{level:3,title:"modifyClientRenderOpts",slug:"modifyclientrenderopts",children:[]},{level:3,title:"rootContainer",slug:"rootcontainer",children:[]},{level:3,title:"onAppCreated",slug:"onappcreated",children:[]},{level:3,title:"render",slug:"render",children:[]},{level:3,title:"onRouterCreated",slug:"onroutercreated",children:[]}]},{level:2,title:"更多配置项",slug:"更多配置项",children:[]}],filePathRelative:"guide/runtime-config.md",git:{updatedTime:1680249231e3,contributors:[{name:"wanchun",email:"445436867@qq.com",commits:1}]}}},74:(n,s,a)=>{a.r(s),a.d(s,{default:()=>t});const p=(0,a(6252).uE)('

运行时配置

Fes.js 约定 src/app.js 为运行时配置文件。运行时配置和配置的区别是他跑在浏览器端，因此我们可以在这里写函数、引入浏览器端依赖项等等，注意不要引入 node 端依赖项。

运行时为啥需要配置？

Fes.js 框架跟传统开发模式不一样。传统开发模式中用户编写 entry 文件，而 Fes.js 中 entry 文件由框架生成，用户就不必要编写胶水代码。内置插件和其他插件提供的一些运行时功能提供用户或者其他插件自定义。

例如：

plugin-acess插件定义运行时配置项：

api.addRuntimePluginKey(() => 'access');\n
1

plugin-acess插件读取配置项：

const runtimeConfig = plugin.applyPlugins({\n    key: 'access',\n    type: ApplyPluginsType.modify,\n    initialValue: {}\n});\n
1
2
3
4
5

而用户则只需要配置：

// app.js\nexport const access = memo => ({\n    ...memo\n    unAccessHandler({\n        router, to, from, next\n    }) {\n        // 处理逻辑\n    },\n    noFoundHandler({\n        router, to, from, next\n    }) {\n        // 处理逻辑\n    },\n});\n\n
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

配置项

beforeRender

beforeRender(lastOpts)

在渲染之前执行，执行action过程中显示 loading 配置的组件，执行结果作为参数 initialState 传给 modifyClientRenderOpts。

示例：

// app.js\nimport { access } from '@fesjs/fes';\nimport PageLoading from '@/components/PageLoading';\nimport UserCenter from '@/components/UserCenter';\n\nexport function beforeRender(lastOpts) {\n    return {\n        ...lastOpts,\n        loading: <PageLoading />,\n        action() {\n            const { setRole } = access;\n            return new Promise((resolve) => {\n                setTimeout(() => {\n                    setRole('admin');\n                    resolve({\n                        userName: 'harrywan'\n                    });\n                }, 1000);\n            });\n        }\n    }\n};\n
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

patchRoutes

patchRoutes({routes })

修改路由。

比如在最前面添加一个 /foo 路由：

export function patchRoutes({ routes }) {\n  routes.unshift({\n    path: '/foo',\n    component: require('@/extraRoutes/foo').default,\n  });\n}\n
1
2
3
4
5
6

提示

直接修改 routes, 不需要返回

modifyClientRenderOpts

modifyClientRenderOpts(lastOpts)

修改 clientRender 参数。参数是一个对象：

比如在微前端里动态修改渲染根节点：

let isSubApp = false;\nexport function modifyClientRenderOpts(lastOpts) {\n  return {\n    ...lastOpts,\n    rootElement: isSubApp ? 'sub-root' : lastOpts.rootElement,    \n  };\n}\n
1
2
3
4
5
6
7

rootContainer

rootContainer(LastRootContainer, args)

修改交给 Vue 渲染时的根组件，默认是 <RouterView></RouterView>。

比如在可以包一层DIV：

export function rootContainer(container) {\n    return () => {\n        return (\n            <div>\n                <RouterView></RouterView>\n            </div>\n        )\n  }\n}\n
1
2
3
4
5
6
7
8
9

onAppCreated

onAppCreated({app})

创建 app 实例后触发。

比如用于安装 Vue 插件：

import { createRouter } from "vue-router";\n\nexport function onAppCreated({ app }) {\n    const router = createRouter();\n    app.use(router);\n}\n\n
1
2
3
4
5
6
7

render

render(oldRender: Function)

覆写 render。

比如用于渲染之前做权限校验。

onRouterCreated

onRouterCreated({router})

生成router时触发。

比如用于收集切换路由的记录：

export function onRouterCreated({ router }) {\n    router.afterEach((to, from) => {\n        console.log(to)\n    });\n}\n
1
2
3
4
5

更多配置项

Fes.js 允许插件注册运行时配置，如果你使用插件，肯定会在插件里找到更多运行时的配置项。

',51),e={},t=(0,a(3744).Z)(e,[["render",function(n,s){return p}]])},3744:(n,s)=>{s.Z=(n,s)=>{const a=n.__vccOpts||n;for(const[n,p]of s)a[n]=p;return a}}}]);