Layui左侧菜单栏宽度和背景色须通过自定义CSS覆盖实现;需用class切换控制宽度(如.layui-side-collapsed)、配合transition动画,并同步更新.layui-body的left值,背景色直接设background属性而非依赖预设类。

Layui 的左侧菜单栏宽度和背景色不能通过配置项直接修改,必须靠自定义 CSS 覆盖原生样式。关键不是改 JS 或调用某个方法,而是精准控制 `.layui-side` 及其子元素的样式,并确保不破坏 Layui 的布局逻辑和交互状态。
改宽度:用 class 切换 + CSS 过渡
不要用内联 style 或 jQuery animate 直接设 width,否则会和 `.layui-body` 的 left 偏移不同步,导致内容遮挡或留白。
- 在自定义 CSS 文件中定义两个状态:
.layui-side { width: 200px; transition: width .3s ease; }
.layui-side.layui-side-collapsed { width: 60px; overflow: hidden; } - JS 中只做状态切换:
$('.layui-side').toggleClass('layui-side-collapsed');
同时同步更新主体区域:
$('.layui-body, .layui-footer').css('left', isCollapsed ? '60px' : '200px'); - 收起后图标居中、文字隐藏需额外控制:
.layui-side-collapsed .layui-nav-item a { justify-content: center; padding-left: 15px; text-align: center; }
.layui-side-collapsed .layui-nav-child { display: none !important; }
改背景色:优先覆盖 .layui-bg-black 或直接设 background
`.layui-bg-black` 是 Layui 提供的预设背景类,但它的色值是固定的(#1f1f1f)。如需自定义,建议不用它,直接写 background:
- 给 `.layui-side` 设置背景色(支持渐变、图片):
.layui-side { background: linear-gradient(135deg, #2c3e50, #1a252f); } - 若需保留 hover 或选中态高亮效果,一并覆盖子项样式:
.layui-nav-itemed > a, .layui-nav-item a:hover { background-color: rgba(255,255,255,.05); } - 注意:避免用 `!important` 覆盖所有地方,只在必要选择器层级加权,例如:
.layui-side .layui-nav-tree .layui-nav-item a { background: transparent; }
注意事项:避开常见坑
- 别在 `element.render()` 前操作 class —— 它会清掉你手动加的 `layui-side-collapsed`
- 不要用 `display: none` 隐藏整个侧边栏,会导致鼠标悬停失效、子菜单无法展开
- 背景图设置建议用 `background-size: cover` 和 `background-attachment: fixed`,防止滚动时错位
- 移动端需加媒体查询,默认收起更友好:
@media (max-width: 768px) { .layui-side { width: 60px !important; } .layui-body { left: 60px !important; } }


















