From ad7aa82afc5c9b56ea6f0bbb3757993283a77097 Mon Sep 17 00:00:00 2001 From: kangwenjing <1138819403@qq.com> Date: Thu, 15 Oct 2026 12:22:31 +0800 Subject: [PATCH] =?UTF-8?q?feat(sidebar):=20=E9=87=8D=E6=9E=84=E8=8F=9C?= =?UTF-8?q?=E5=8D=95=E5=B1=82=E7=BA=A7=E6=A0=B7=E5=BC=8F=E4=B8=8E=E5=9B=BE?= =?UTF-8?q?=E6=A0=87=E5=8D=A0=E4=BD=8D=E5=AF=B9=E9=BD=90=E9=80=BB=E8=BE=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 新增菜单层级 depth 计算,限制最深缩进为5级避免内容截断 - 统一菜单行对齐样式,修复图标与文字垂直居中问题 - 新增层级引导线样式,替换部分层级加粗区分 - 优化三级及以下菜单的行高、圆角和文字样式 - 新增菜单图标占位元素,保证无图标时文案对齐 - 适配折叠态菜单的图标居中与占位元素隐藏 --- .../oms_vue/src/assets/styles/sidebar.scss | 189 +++++++++++++++--- .../src/layout/components/Sidebar/Item.vue | 27 ++- .../layout/components/Sidebar/SidebarItem.vue | 35 +++- 3 files changed, 220 insertions(+), 31 deletions(-) diff --git a/oms_web/oms_vue/src/assets/styles/sidebar.scss b/oms_web/oms_vue/src/assets/styles/sidebar.scss index 3c72476e..a3907165 100644 --- a/oms_web/oms_vue/src/assets/styles/sidebar.scss +++ b/oms_web/oms_vue/src/assets/styles/sidebar.scss @@ -5,6 +5,79 @@ * 布局骨架(固定定位 / 折叠 / 移动端抽屉)沿用若依原有实现。 */ +/* ---------- 菜单行对齐 ---------- */ +/* 图标盒子尺寸与图标—文案间距,展开态和折叠弹出菜单共用 */ +$sidebar-icon-size: 16px; +$sidebar-icon-gap: 8px; + +/* + * 菜单行(一级项 / 分组标题 / 子项)统一用 flex 做视觉居中。 + * 原来靠 line-height + vertical-align 对齐,SvgIcon 组件自带的 + * vertical-align: -0.15em 会让图标中心高于文字视觉中心约 3px, + * 且不同 viewBox 的图标高低不一;flex 下图标盒子直接对齐行中心。 + */ +@mixin menu-row-align($icon-size: $sidebar-icon-size, $icon-gap: $sidebar-icon-gap) { + display: flex; + align-items: center; + + .svg-icon, + [class^='el-icon-'] { + flex: 0 0 auto; + display: block; + width: $icon-size; + height: $icon-size; + margin-right: $icon-gap; + font-size: $icon-size; + line-height: 1; + text-align: center; + // 图标颜色跟随菜单文字(含 hover / 选中态) + color: inherit; + } + + // 子级菜单的 Dot 占位点:字形只占画布约 30%,按整格间距点位和文字会显得松散, + // 单独收紧后它与文案的视觉距离才和真实图标一致(class 由 Sidebar/Item.vue 打标) + .svg-icon.menu-icon-bullet { + margin-right: 3px; + } + + // 一级菜单没配图标时的空槽位,把图标列留给文案对齐(class 由 Sidebar/Item.vue 打标) + .menu-icon-placeholder { + flex: 0 0 auto; + display: block; + position: relative; + width: $icon-size; + height: $icon-size; + margin-right: $icon-gap; + } + + // flex 下省略号要由文案自己负责,否则长菜单名会被直接裁掉 + > span:not(.menu-icon-placeholder) { + min-width: 0; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; + } + + // 折叠态下 element 会把菜单项内容包进 tooltip 触发层(该层被绝对定位铺满整行,并自带 + // 内联 display: inline-block 与 padding: 0 20px),这层也要 flex,图标才会跟着行一起居中 + > .el-tooltip, + > .el-tooltip > div:not(.el-tooltip__popper) { + display: flex !important; + align-items: center; + } +} + +/* ---------- 菜单层级(缩进 / 行高 / 引导线) ---------- */ +/* + * Element 的缩进是每个 submenu 祖先 +20px(写成行内 padding-left),再叠加嵌套 .el-menu + * 自身的 12px 横向 padding,实际每级 32px;四级菜单文案起点到了 128px,可用宽度不到 80px, + * “应收收款核销记录”这类名称会被裁断。这里把横向缩进收回来交给 menu-depth-* 统一控制: + * 嵌套菜单不留横向 padding,胶囊左内边距 12px,三级起每级只走 16px, + * 层级关系改由竖向引导线表达。类名由 Sidebar/SidebarItem.vue 按递归深度输出(最深 5 级)。 + */ +$sidebar-indent-by-depth: (1: 12px, 2: 28px, 3: 44px, 4: 60px, 5: 76px); +$sidebar-row-height: (1: 42px, 2: 38px, 3: 34px, 4: 32px, 5: 32px); + #app { /* 同上:这里不能带 z-index,否则页面内的弹窗 / 抽屉会被 body 上的遮罩盖住 */ .main-container { @@ -62,7 +135,10 @@ display: none; } - a { + // 这条 reset 只服务于菜单里的 app-link(每个菜单项外面套一个 a)。 + // 它带 #app 前缀,特异性高于组件里的 scoped 样式,写宽到整个 sidebar-container + // 会把 logo 链接的 display: flex 也压成块级,名称就被挤到图标下面另起一行。 + .el-menu a { display: inline-block; width: 100%; overflow: hidden; @@ -78,6 +154,7 @@ .el-menu-item, .el-submenu__title { + @include menu-row-align; overflow: hidden !important; text-overflow: ellipsis !important; white-space: nowrap !important; @@ -98,20 +175,6 @@ } } - .el-menu-item [class^='el-icon-'], - .el-submenu__title [class^='el-icon-'] { - margin-right: 12px; - width: 20px; - text-align: center; - font-size: 16px; - } - - .svg-icon { - margin-right: 12px; - width: 18px; - height: 18px; - } - // 选中态:primary-50 胶囊 + 主色文字 .el-menu-item.is-active { background-color: $s2-primary-50 !important; @@ -124,16 +187,73 @@ } } - // 子菜单层级留白 - .nest-menu .el-submenu > .el-submenu__title, - .el-submenu .el-menu-item { - min-width: auto !important; - height: 38px; - line-height: 38px; + // 嵌套子菜单:横向缩进交给 menu-depth-*,这里只留一点纵向留白 + .el-menu--inline { + position: relative; + padding: 0 0 4px; + } + + @each $d, $pad in $sidebar-indent-by-depth { + $child-h: if($d >= 5, 32px, map-get($sidebar-row-height, $d + 1)); + + // Element 的缩进写在行内样式上,覆盖它必须带 !important + .el-menu-item.menu-depth-#{$d}, + .el-submenu.menu-depth-#{$d} > .el-submenu__title { + min-width: auto !important; + padding-left: $pad !important; + height: map-get($sidebar-row-height, $d); + line-height: map-get($sidebar-row-height, $d); + } + + // 子级组左侧引导线:竖在上一层图标的中心,末端停在最后一行的行高中心 + .el-submenu.menu-depth-#{$d} > .el-menu--inline::before { + content: ''; + // element-ui 的 .el-menu::before 是 clearfix(display: table), + // 绝对定位下表格盒会按内容高度塌成 0,这里必须显式回到 block + display: block; + position: absolute; + top: 0; + bottom: $child-h / 2 + 6px; + left: $pad + $sidebar-icon-size / 2 - 0.5px; + width: 1px; + background-color: $s2-gray-200; + } + } + + // 三四级行高更矮,胶囊圆角跟着收一档;标题不再加粗,靠缩进和引导线分层 + .el-menu-item.menu-depth-3, + .el-menu-item.menu-depth-4, + .el-menu-item.menu-depth-5, + .el-submenu.menu-depth-3 > .el-submenu__title, + .el-submenu.menu-depth-4 > .el-submenu__title, + .el-submenu.menu-depth-5 > .el-submenu__title { + border-radius: 10px; + font-weight: 500; + } + + // 深层叶子行右侧没有展开箭头,收一点留白把宽度让给菜单名, + // 否则“应收收款核销记录”这类 8 字名称还是会出省略号 + .el-menu-item.menu-depth-3, + .el-menu-item.menu-depth-4, + .el-menu-item.menu-depth-5 { + padding-right: 12px !important; + } + + // 四级是叶子节点,浅色主题下文字再轻一档;排除选中态避免盖掉主色, + // 深色主题沿用 accent-300(gray-500 在深色底上对比度不够) + &:not(.is-dark) { + .el-menu-item.menu-depth-4:not(.is-active), + .el-menu-item.menu-depth-5:not(.is-active) { + color: $s2-gray-500; + } } /* ---------- 深色分支 ---------- */ &.is-dark { + .el-submenu > .el-menu--inline::before { + background-color: rgba(255, 255, 255, 0.12); + } + .el-menu-item, .el-submenu__title { color: $s2-accent-300; @@ -170,11 +290,33 @@ justify-content: center; } + // 折叠态图标位于 tooltip 触发层内,同样水平居中 + .el-menu-item > .el-tooltip, + .el-menu-item > .el-tooltip > div:not(.el-tooltip__popper) { + justify-content: center; + padding: 0 !important; + } + .svg-icon, + .svg-icon.menu-icon-bullet, .el-menu-item [class^='el-icon-'], .el-submenu__title [class^='el-icon-'] { margin-right: 0; } + + // 折叠态只留图标:menu-depth-* 的缩进选择器比上面那条更具体, + // 不逐层取消掉的话图标会被 padding-left 挤离行中心 + @each $d, $pad in $sidebar-indent-by-depth { + .el-menu-item.menu-depth-#{$d}, + .el-submenu.menu-depth-#{$d} > .el-submenu__title { + padding-left: 0 !important; + } + } + + // 折叠态没有文案需要对齐,占位槽直接收掉 + .menu-icon-placeholder { + display: none; + } } .main-container { @@ -248,8 +390,9 @@ /* ---------- 折叠后的弹出子菜单 ---------- */ .el-menu--vertical { & > .el-menu { - .svg-icon { - margin-right: 12px; + .el-menu-item, + .el-submenu__title { + @include menu-row-align; } } diff --git a/oms_web/oms_vue/src/layout/components/Sidebar/Item.vue b/oms_web/oms_vue/src/layout/components/Sidebar/Item.vue index be3285df..f89ba59c 100644 --- a/oms_web/oms_vue/src/layout/components/Sidebar/Item.vue +++ b/oms_web/oms_vue/src/layout/components/Sidebar/Item.vue @@ -1,4 +1,15 @@ +