4.3 KiB
Portal 恢复左侧子菜单 + 可折叠 — Implementation Plan
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
Goal: Portal 布局恢复左侧二/三级菜单并支持折叠,顶栏保留一级模块下拉,移除水平子导航。
Architecture: 在 views/index/index.vue Portal 分支恢复 #app-sidebar + ArtSidebarMenu;ArtPortalHeader 增加折叠按钮并卸载 ArtPortalSubNav/ArtPortalMobileMenu;删除 art-sidebar-menu 中 Portal 强制展开逻辑;style.portal.scss 改为 flex row 并补充窄屏 overlay。
Tech Stack: Vue 3 · Element Plus · Pinia · vue-router · SCSS
Spec: docs/superpowers/specs/2026-07-04-portal-sidebar-restore-design.md
Task 1: 恢复 Portal 布局 DOM 结构
Files:
-
Modify:
web-admin/src/views/index/index.vue -
Modify:
web-admin/src/views/index/style.portal.scss -
Step 1: 在 Portal 分支
#app-portal-body内恢复侧栏结构
<div id="app-portal-body">
<aside id="app-sidebar">
<ArtSidebarMenu />
</aside>
<main id="app-workspace">
<div id="app-content">
<ArtPageContent />
</div>
</main>
</div>
-
Step 2:
onMounted中删除无条件setMenuOpen(true),保留 PORTAL 强制与enforceSinglePageTabs -
Step 3:
style.portal.scss将#app-portal-body改为display: flex; flex-direction: row; min-height: 0; flex: 1 -
Step 4: 新增
#app-sidebar { flex-shrink: 0; height: 100% }与#app-workspace { flex: 1; min-width: 0 } -
Step 5: 复制
style.scss中 ≤800px#app-sidebarfixed overlay 规则到.app-layout-portal作用域
Task 2: 顶栏增加折叠按钮并精简
Files:
-
Modify:
web-admin/src/components/core/layouts/art-portal-header/index.vue -
Step 1: 移除
<ArtPortalSubNav />与<ArtPortalMobileMenu />模板引用 -
Step 2: 在
portal-header-actions最前增加折叠按钮
<ArtIconButton
icon="fold"
class="portal-header-icon-btn portal-header-fold-btn"
@click="toggleSidebar"
/>
- Step 3: script 中注入
useSettingStore、menuOpen,实现toggleSidebar
const settingStore = useSettingStore()
const { menuOpen } = storeToRefs(settingStore)
const toggleSidebar = () => settingStore.setMenuOpen(!menuOpen.value)
-
Step 4: 删除 template 中
portal-sub-nav相关:deep样式块;保留 module-select 与 actions 样式 -
Step 5: 调整
portal-header-nav:仅保留ArtPortalModuleSelect(去掉 sub-nav flex:1 占位)
Task 3: 放开 Portal 侧栏折叠
Files:
-
Modify:
web-admin/src/components/core/layouts/art-menus/art-sidebar-menu/index.vue -
Modify:
web-admin/src/config/setting.ts -
Step 1: 删除
watch(width)中isPortalMenu强制setMenuOpen(true)分支,改为与 LEFT 布局相同的移动端处理
watch(width, (newWidth) => {
if (newWidth < MOBILE_BREAKPOINT) {
settingStore.setMenuOpen(false)
if (!menuOpen.value) showMobileModal.value = false
} else {
showMobileModal.value = false
}
})
-
Step 2:
config/setting.ts将menuOpenWidth从230改为220 -
Step 3: 确认 Portal 侧栏
menu-model遮罩在移动端仍可点击关闭(已有逻辑,手测)
Task 4: 全局样式对齐
Files:
-
Modify:
web-admin/src/assets/styles/core/app.scss -
Step 1: 在
#app-sidebar规则后补充 Portal 作用域(若 scoped 未覆盖)
.app-layout-portal #app-sidebar .layout-sidebar {
height: 100%;
border-right: 1px solid var(--mint-border) !important;
background: var(--mint-surface);
}
- Step 2: 确认
.layout-sidebar-portal高度为100%(art-sidebar-menu/style.scss已有)
Task 5: 验证
-
Step 1:
cd web-admin && pnpm lint -
Step 2:
./scripts/update-graph.sh frontend(shanxia2.0 根目录) -
Step 3: 浏览器手测
- 登录后侧栏展示当前模块子菜单
- 顶栏折叠按钮切换 220px / 64px
- 一级下拉切换模块后侧栏更新
- 视口 ≤800px 侧栏抽屉 + 遮罩
- 刷新后
menuOpen状态保持