关于Layui的layer弹出层，许多前端开发者都曾遇到这样的困惑：明明正确配置了full回调函数，可当点击最大化按钮时，预期的业务逻辑却始终没有触发。这种现象背后，其实隐藏着一系列精确的触发条件与常见的参数配置陷阱，两者共同作用导致了问题的出现。
简单来说，要让full回调生效，必须同时满足两个硬性前提：第一，maxmin参数必须设置为true；第二，弹层的type类型必须是1（页面层）或2（iframe层）。如果你配置了回调却没有反应，绝大多数情况是弹层类型选择有误，或者根本没有将最大化按钮显示出来。
这些场景，会让你的full回调彻底“沉默”
首先需要明确，full回调并非一个全局的事件监听器。它不会监听页面中所有弹层的最大化动作，而是Layui内部在两种特定条件下同步触发的函数：一是用户点击了弹窗右上角的最大化按钮，二是开发者主动调用了layer.full(index)方法。
因此，以下配置方式都会导致回调函数被直接忽略，并且Layui不会抛出任何错误提示：
- 弹层类型不支持最大化：当
type设置为0（信息框）、3（加载层）或4（tips层）时，这些弹层本身不具备最大化功能，full配置自然无法生效。 - 最大化按钮被隐藏：
maxmin: false或者干脆省略了这个参数，按钮都不显示，回调也就无从谈起。 - 手动移除了按钮元素：在
success回调中，如果通过DOM操作移除了.layui-layer-max这个元素，按钮不可点击，回调同样不会被触发。 - 参数名称拼写错误：将
full误写成了onFull、onfull等其他名称，Layui无法识别这些非标准写法。
正确的写法与参数避坑指南
full回调的函数签名是固定的：function(layero, index)。它仅接收两个参数：layero（当前弹层的jQuery DOM对象）和index（该弹层的唯一索引ID）。
layer.open({
type: 1,
content: '内容
',
maxmin: true,
area: ['800px', '600px'],
full: function(layero, index) {
console.log('弹层已最大化，DOM对象:', layero, '层索引:', index);
// 注意：此时layero的尺寸已撑满视口，但iframe内的内容可能尚未完成重绘
}
});
在实际开发中，有几个高频出现的“踩坑”操作值得特别警惕：
- 急于调整iframe尺寸：很多人一进入
full回调，就急着用layero.find('iframe').height('100%')来设置内部iframe的高度。但iframe的高度通常由其父容器（即弹层本身）控制，强行设置很可能被Layui内部的后续样式覆盖。 - 期待不存在的额外参数：尝试在函数中接收第三个参数，比如事件对象
e，这是行不通的，Layui根本不会传递这个参数。 - 在回调中“反复横跳”：在
full回调里直接关闭当前层（layer.close(index)），然后又立刻打开一个新层。这种操作会打断Layui内部的状态管理流程，很可能导致后续的还原（restore）功能失效。
为什么还原后尺寸会错乱，进而影响最大化？
full（最大化）和restore（还原）是一对相伴相生的回调钩子，它们底层共用同一套尺寸计算与还原逻辑。这就引出了一个关键问题：如果初始的area配置使用了百分比，比如['90%', '80%']。
那么，当用户点击还原按钮时，Layui会尝试将百分比换算回具体的像素值。然而，此时浏览器的计算上下文可能已经发生了变化——比如页面滚动条出现或消失、字体加载完成导致布局微调——最终换算出的像素值很可能不准确，导致弹层还原后位置偏移、高度塌陷。
这个错误的还原尺寸，又将成为下一次最大化的基准，从而造成“最大化好像没生效”的错觉。要稳定避开这个坑，通常只有一条路：
- 首选固定像素值：初始化时直接使用
area: ['1200px', '700px']这样的固定值，彻底绕过百分比换算的麻烦。 - 响应式布局的替代方案：如果必须适配不同屏幕，可以放弃
area的百分比，改用offset进行定位，并在restore回调里手动用jQuery重设弹层的宽高：layero.css({width: '90%', height: '80%'})。 - 慎用“auto”高度：对于
type: 1的页面层，要特别小心将area[1]（高度）设为'auto'。在Layui 2.8.x版本中，这可能导致弹层在最小化再还原后，高度直接变为零，这是一个已知的底层限制，目前没有完美的解决方案。
最后提一个容易被忽略的细节：full回调触发时，仅代表弹层本身的DOM布局已经调整为全屏。如果弹层内部包含iframe，其内容的渲染可能尚未完成。因此，如果你需要在最大化后操作iframe内部的元素，正确的做法是等待iframe的contentWindow加载就绪，而不是直接在full回调里执行操作。
