laydate.done回调在用户完成明确确认动作(如点确定、今天、输入后失焦或点空白区域)时触发,value值为日期字符串表示有效选择,空字符串表示清空;严格限定仅点确定按钮触发需手动监听按钮点击。

laydate.done 回调就是关闭后触发的,但得搞清“关闭”指什么
laydate 的 done 回调不是“面板消失那一刻”才执行,而是只要用户完成一次**明确确认动作**就触发:点「确定」按钮、点「今天」、手动输入后失焦、甚至点空白区域关闭面板——全算。它不区分是点击还是回车,也不管你有没有改值。
常见误判是以为只有点「确定」才算“关闭后”,结果发现点「今天」或输完回车也进了 done,业务逻辑被意外触发。
-
done的第一个参数value是唯一可靠判断依据:有值(如"2026-10-02")表示选了有效日期;空字符串""表示点了「清空」;null或undefined基本不会出现 - 别依赖
date对象判空——清空时它仍返回默认时间(如{year: 2026, month: 9, date: 2}),看起来像“没清空” - 如果页面有多个日期控件共用同一套
done逻辑,记得用this.elem拿到当前实例绑定的 input 元素,避免操作错 DOM
想严格限定“只在点确定按钮后触发”,只能手动监听按钮点击
layui 2.8.x 自带的 laydate(通常是 v5.0.9)不支持 onConfirm,写进去等于没写。必须绕过 API,直接操作 DOM:
- 在
ready回调里用document.querySelector('.layui-laydate-footer .layui-btn-primary')找到「确定」按钮 - 绑定
onclick,里面读取document.getElementById('xxx').value获取当前输入值 - 手动调用
picker.close()关闭面板(注意:picker是ready函数的第二个参数,不是全局变量) - 如果用了自定义按钮(比如
btns: ['clear', 'now', 'confirm']),按钮 class 可能不同,得查实际渲染出的 HTML 结构
外部点击关闭时,done 也会执行,但时机不可控
用户点面板外区域关闭日历,done 确实会触发,但这时 value 是上次选中的值(或空),无法区分是“确认后关闭”还是“放弃选择”。如果你的业务要求“只在主动确认后才提交”,这种场景就得放弃依赖 done,改用上一条的手动按钮监听。
另外要注意:showBottom: false 会让 done 行为变成“面板一关就触发”,连年份滚动后失焦都算,完全失去控制力。
- 不要在
done里做异步请求,除非你明确接受多次触发(比如用户反复点「今天」) - 如果同时要重置关联控件(如结束时间的
min),必须在value === ""分支里手动还原原始值,否则联动逻辑会卡死 - 多个日期控件共存时,别用全局
$('.layui-laydate')删除面板——会误删其他实例
v5.1.0+ 可以用 onConfirm,但得确认你真用的是这个版本
很多人以为升级了 layui 就自动带新版 laydate,其实不是。layui 2.8.x 默认打包的是 laydate v5.0.9,onConfirm 和 onclear 配置项会被静默忽略。验证方法很简单:在 render 里写个明显错误的配置(比如 onConfirm: console.error),看控制台会不会报错——不报错也不执行,基本就是旧版。
- 确认是 v5.1.0+ 后,
onConfirm才真正只在点「确定」时触发,且不响应手动输入失焦 -
onConfirm的参数和done一样,但语义更清晰,适合做最终校验(比如检查是否晚于开始时间) - 别混用
done和onConfirm——旧版onConfirm不生效,新版两者同时存在会导致重复执行
真正的难点不在怎么写回调,而在于你怎么定义“关闭后”。是用户松手那一刻?还是他按下确定键那一瞬?不同定义对应完全不同的实现路径,选错一个,后面全是补丁。











