Layui标签页默认不支持双行展示,需通过CSS弹性换行或JS动态插入换行节点实现;推荐方案为设置.layui-tab-title为flex-wrap:wrap并禁用溢出隐藏,兼顾兼容性与简洁性。

Layui 原生的标签页(通常指 layui-tab 或第三方多标签页插件,如 SummerAdmin 中集成的 tab 系统)默认不支持双行展示或自动换行。它的标签栏是单行横向滚动布局,超出宽度时显示左右箭头或隐藏溢出项。但实际项目中,确实常有“标签太多、一行放不下、又不想滚动”的需求。实现双行或自动换行,需绕过原生限制,通过 CSS + 少量 JS 主动控制布局行为。
以下是两种主流、稳定、已在生产环境验证的方案:
标签栏容器启用弹性换行(推荐)
适用于基于 .layui-tab-title 的自定义 tab 结构(如 SummerAdmin、Layui 扩展 tab 插件等),核心是让标题容器支持 flex 换行:
.layui-tab-title {
display: flex;
flex-wrap: wrap;
overflow: visible; /* 关键:禁用隐藏溢出 */
padding-right: 0; /* 避免右侧留白干扰换行对齐 */
}
.layui-tab-title li {
flex: 0 0 auto; /* 禁止拉伸,保持原始宽度 */
margin-right: 5px;
margin-bottom: 4px; /* 行间距 */
}✅ 优点:纯 CSS 实现,无 JS 依赖,兼容性好(IE10+),响应及时
⚠️ 注意:需确保父容器(如.layui-tab)高度足够容纳多行;若使用 iframe 嵌套内容页,建议同步调整.layui-tab-content的 top 值或用 JS 动态计算高度
动态计算并插入换行节点(精准控制)
当标签数量动态变化、且需严格按行数/字符数截断时,可用 JS 在指定位置插入 <li class="tab-break"> 占位:
function wrapTabTitles(maxPerRow = 6) {
const titles = document.querySelectorAll('.layui-tab-title li');
let count = 0;
titles.forEach((li, i) => {
if (count % maxPerRow === 0 && i > 0) {
const br = document.createElement('li');
br.className = 'tab-break';
br.style.cssText = 'flex-basis: 100%; height: 0; margin: 0; padding: 0;';
li.parentNode.insertBefore(br, li);
}
count++;
});
}
// 页面加载后或新增标签时调用
wrapTabTitles(5);配套样式:
.tab-break { order: 999; }
.layui-tab-title { display: flex; flex-wrap: wrap; }✅ 优点:可精确控制每行数量,适合固定宽度场景
⚠️ 注意:需在 tab 切换、新增、关闭后重新执行,建议封装为refreshTabs()方法统一管理
不建议的做法
- 直接修改
layui.css中.layui-tab-title的white-space: normal—— Layui 内部 JS 依赖单行布局做高亮定位,强行改会导致选中态错位; - 使用
float: left替代 flex —— 兼容性差,且与 Layui 的动态宽度计算逻辑冲突; - 依赖第三方 tab 插件却未查清其是否支持换行(例如部分基于 iframe 的 tab 系统根本不允许 DOM 层级干预)。
本质上,Layui 的设计哲学是“轻量可控”,它把布局自由度留给开发者。顶部标签栏不是框架强约束的部分,而是典型可定制区域。只要结构语义清晰(如每个 tab 是 <li>)、事件绑定合理(click 仍能触发 tabChange),换行就是 CSS 层面的样式工程,无需动核心 JS。
不复杂但容易忽略。


















