full回调仅在type为1或2且maxmin:true时触发,是layer.full()或点击最大化按钮后的同步执行函数,不监听所有最大化动作;type为0/3/4、maxmin:false、拼写错误、area用百分比等均会导致失效。
必须设 maxmin: true 且 type 为 1 或 2,full 回调才会触发;设了但没反应,八成是类型或配置写错了。
full 回调什么情况下根本不会执行
它不是“监听页面上所有最大化动作”的监听器,而是 layui 内部在点击按钮或调用 layer.full() 后同步执行的函数。以下情况会导致它静默失效:
-
type是0(信息框)、3(加载层)或4(tips 层)——这些类型压根不支持最大化,full配置会被忽略 -
maxmin: false或直接没写,此时最大化按钮都不显示,更别提回调 - 在
success回调里手动移除了 .layui-layer-max,导致按钮不可点 - 把
full写成了onFull、onfull等拼写错误名
正确写法和参数含义
full 是一个函数,只接收两个参数:layero(当前弹层的 DOM 元素)和 index(该弹层的 layer ID),签名固定为 function(layero, index):
layer.open({
type: 1,
content: '<div>内容</div>',
maxmin: true,
area: ['800px', '600px'],
full: function(layero, index) {
console.log('已最大化,DOM:', layero, 'ID:', index);
// 注意:此时 layero 已撑满视口,但 iframe 内容可能还没重绘
}
});
常见误操作:
- 想在
full里直接改layero.find('iframe').height('100%')—— iframe 高度由父层控制,强行设可能被覆盖 - 传入第三个参数,比如事件对象
e—— layui 不传,写了也收不到 - 在
full里调layer.close(index)又立刻layer.open—— 会打断内部状态,可能导致后续restore失效
为什么 restore 后尺寸错位,连带影响 full 的可用性
full 和 restore 是一对钩子,但它们共用一套尺寸还原逻辑。如果 area 初始值用了 ['90%', '80%'] 这类百分比,restore 会尝试转成像素,而浏览器计算上下文可能已变(比如滚动条出现、字体加载延迟),结果就是还原后位置偏、高度塌陷 —— 这反过来会让下一次 full 基于错误尺寸撑开,看起来“最大化没生效”。
稳解法只有一条:
- 初始化时用固定像素值:
area: ['1200px', '700px'],彻底避开百分比换算 - 若必须响应式,放弃
area百分比,改用offset定位 + 在restore里手动重设layero.css({width: '90%', height: '80%'}) -
type: 1页面层慎用area[1]: 'auto',最小化再还原极易高度归零,这是 layui 2.8.x 的硬伤,绕不开
真正容易被忽略的点是:full 触发时,DOM 已完成布局,但子内容(尤其是 iframe)未必完成渲染。如果你要在最大化后调整 iframe 内部元素,得等 layero.find('iframe')[0].contentWindow 加载完成,而不是依赖 full 回调本身。











