Layui可通过layout模块与原生拖拽逻辑实现左右分栏:1. HTML用split-container包裹左右栏及拖拽条;2. CSS用flex布局并定位拖拽条;3. JS监听mousedown/mousemove/mouseup事件动态调整宽度并限制范围。

Layui 本身没有内置的左右分栏(Splitter)组件,但可以通过 layui 的 layout 模块 + 原生 DOM 拖拽逻辑 快速实现可拖拽调整宽度的左右分栏布局,无需额外引入插件。
1. 基础 HTML 结构(左右两栏 + 拖拽条)
用一个外层容器包裹左栏、拖拽条、右栏,注意拖拽条需设为绝对定位或 inline-block,并预留足够 z-index:
<div class="split-container"> <div class="split-left">左侧内容</div> <div class="split-bar"></div> <div class="split-right">右侧内容</div> </div>
2. CSS 样式控制(关键:flex + 拖拽条定位)
推荐使用 Flex 布局保证自适应,拖拽条设为固定宽度(如 6px),并覆盖在两栏交界处:
.split-container {
display: flex;
height: 100vh;
}
.split-left {
flex: 0 0 280px; /* 初始宽度 */
background: #f8f9fa;
overflow: auto;
}
.split-right {
flex: 1;
background: #fff;
overflow: auto;
}
.split-bar {
width: 6px;
background: #e5e5e5;
cursor: col-resize;
transition: background .2s;
z-index: 10;
}
.split-bar:hover { background: #009688; }
/* 确保拖拽条在中间、不换行 */
.split-container > * { height: 100%; }
3. JavaScript 实现拖拽逻辑(原生,兼容 layui)
监听 mousedown → 记录初始位置和左右栏宽度 → mousemove 动态更新宽度 → mouseup 清理事件。注意限制最小宽度(如 200px)防止崩溃:
layui.use([], function(){
const container = document.querySelector('.split-container');
const left = document.querySelector('.split-left');
const bar = document.querySelector('.split-bar');
let isDragging = false;
let startX, startLeftWidth;
<p>bar.addEventListener('mousedown', function(e) {
isDragging = true;
startX = e.clientX;
startLeftWidth = left.offsetWidth;
document.body.style.cursor = 'col-resize';
e.preventDefault();
});</p><p>document.addEventListener('mousemove', function(e) {
if (!isDragging) return;
const diff = e.clientX - startX;
const newWidth = startLeftWidth + diff;
// 限制最小/最大宽度
if (newWidth >= 200 && newWidth <= container.offsetWidth - 200) {
left.style.flex = <code>0 0 ${newWidth}px</code>;
}
});</p><p>document.addEventListener('mouseup', function() {
if (isDragging) {
isDragging = false;
document.body.style.cursor = '';
}
});
});4. 进阶建议(提升体验)
- 添加
user-select: none到.split-bar,避免拖拽时文字被选中 - 拖拽结束时将当前宽度存入 localStorage,刷新后恢复
- 若嵌套在 layui admin 框架中,注意容器高度由
.layui-body控制,需确保其有明确高度(如height: calc(100vh - 60px)) - 移动端暂不支持鼠标拖拽,如需适配,可补充
touchstart/touchmove事件(但通常 PC 端为主)


















