Files
shanxia2.0/docs/superpowers/plans/2026-07-04-portal-sidebar-restore.md
T
2026-07-05 10:07:24 +08:00

4.3 KiB
Raw Blame History

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-sidebar fixed 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 状态保持