布局组件
布局组件用于替换平台级顶栏、侧栏等框架部分。它适合处理品牌化布局、导航交互和整体壳层体验，而不是承接具体业务页面内容。
什么时候用布局组件
- 需要统一替换顶栏、侧栏或导航交互
- 需要把平台壳层改造成更符合业务品牌的风格
- 标准布局已经无法承接多层导航、特殊入 口或企业门户化展示
如果你只是想替换某个业务页面，请优先使用 微前端应用；如果你要替换登录页，请看 平台自定义登录页集成指南。
先明确它不该做什么
布局组件最容易被误用成“顺手把业务页面也做进去”的壳层工程，但这通常会让壳层和业务界面越来越难拆开。
建议把边界收成这样：
- 布局组件负责：顶栏、侧栏、导航、主题、框架级交互
- 微前端页面负责：具体业务页面和业务状态流转
- 组件库负责：低代码页面里的复用控件
如果你发现布局工程里开始堆积表单、列表、审批页和业务查询逻辑，通常说明承载层已经选错了。
这类组件通常要消费哪些宿主能力
| 宿主能力 | 常见用途 |
|---|---|
| 菜单数据 | 渲染侧栏、导航树、快捷入口 |
| 用户信息 | 顶栏头像、当前身份、个人菜单 |
| 主题信息 | 壳层风格、品牌色、深浅模式 |
| 路由跳转能力 | 点击导航或快捷入口后切换页面 |
| 面包屑 / 当前应用信息 | 顶部路径、上下文标题、应用切换 |
这些能力请结合 前端 SDK 初始化方法 一起看。
实现步骤
构建应用
自选前端技术，创建布局应用。
注意
布局应用应避免路由的注入。
应用改造
打包与配置
- 构建应用程序，并将其打包成 zip 文件。
- 在“高级 -> 微前端”中新增微前端，管理界面的类型选择微前端组件，查看具体配置方式。
- 在“应用配置”中选择对应的自定义顶栏或侧边栏入口。
接入提示
- 布局组件通常需要消费宿主提供的菜单、面包屑、主题和用户信息，这些能力请结合 前端 SDK 初始化方法 一起看。
- 布局组件要尽量保持壳层职责清晰，不要把具体业务页面直接耦合进布局代码里。
- 如果同时定制顶栏和侧栏，建议由同一个前端工程统一维护，减少壳层风格和交互割裂。
- 如果你们已经需要让一批壳层能力被多个应用统一共享，再进一步评估 平台组件库。