要在 Layui layer 弹层右上角添加刷新按钮,需用 lay-template 预声明图标按钮,success 回调中用 before() 插入 .layui-layer-close 前,绑定点击事件执行刷新逻辑(勿 close),并设置 line-height、top、margin-right 及 hover 旋转动画确保样式与交互正确。

要在 Layui 的 layer 弹出层右上角添加一个自定义工具按钮(比如刷新图标),必须绕过默认的 closeBtn 机制,用 DOM 注入方式手动插入按钮,并绑定点击逻辑——直接改 .layui-layer-close 样式或覆盖 class 会导致 ESC 键仍可关闭、且无法响应自定义事件。
准备一个可点击的刷新图标按钮
在页面任意位置(如
底部)添加一段 script 模板,定义按钮结构和图标:<script type="text/html" id="refreshToolBtn"><i class="layui-icon layui-icon-refresh" style="font-size:18px; cursor:pointer; margin-right:12px;"></script>
这一步不能省略为内联 HTML,因为 layer 的 success 回调中动态创建的 DOM 若含 layui-icon,需等字体文件加载完成才渲染;提前用 lay-template 声明可确保图标就绪。
在弹层打开时注入按钮到右上角
调用 layer.open 时,在 success 回调里定位右上角容器并追加按钮:
success: function(layero, index){
var $closeBtn = layero.find('.layui-layer-close');
if($closeBtn.length){
$closeBtn.before($('#refreshToolBtn').html());
}
}
注意:必须用 before() 插入在 .layui-layer-close 之前,否则按钮会出现在关闭 × 右侧,视觉错位。如果页面没引入 layui.icon.css 或字体未加载,图标将显示为方块——此时要检查 是否完整引入。
给刷新按钮绑定点击事件
方法一:在 success 回调中直接绑定(推荐,作用域明确)
success: function(layero, index){
var $refresh = layero.find('.layui-icon-refresh');
$refresh.on('click', function(){
// 此处写你的刷新逻辑,例如重载表格
table.reload('userTable', {
page: {curr: 1},
where: $('#searchForm').serializeObject()
});
});
}
方法二:用事件委托(适合多个弹层复用)
$(document).on('click', '.layui-icon-refresh', function(){
var index = $(this).closest('.layui-layer').attr('times');
// 通过 index 查找对应弹层里的表格 ID 或其他上下文
});
⚠️关键提醒:【不要在 click 回调里调用 layer.close(index)】,这个按钮是“刷新”不是“关闭”,误关会导致用户操作中断。
调整按钮位置与鼠标样式
第一步:确保按钮垂直居中对齐
layero.find('.layui-icon-refresh').css({
'line-height': '24px',
'position': 'relative',
'top': '2px'
});
第二步:悬停时加轻微旋转动画增强反馈
layero.find('.layui-icon-refresh').hover(
function(){ $(this).addClass('layui-anim layui-anim-rotate'); },
function(){ $(this).removeClass('layui-anim layui-anim-rotate'); }
);
第三步:避免遮挡关闭按钮,右侧留出 6px 间距
layero.find('.layui-icon-refresh').css('margin-right', '6px');


















