laydate 的 year/month 模式需 type 与 format 严格配对,value 必须为合法日期字符串(如 "2026-01-01"),min/max 格式须匹配 format,点选即关需在 change 中同步输入框并移除浮层。
laydate type="year" 或 type="month" 是唯一正确入口
直接设 type: "year" 或 type: "month" 就能切换面板形态,不需要隐藏日历、不依赖 css、也不用监听 click 自行关闭。这是 laydate 原生支持的能力。
但必须配对 format:
-
type: "year"→ 必须写format: "yyyy",返回值如"2026" -
type: "month"→ 必须写format: "yyyy-MM",返回值如"2026-06"
常见错误是只改 format 却不改 type,比如 type: "date" + format: "yyyy-MM",结果日历仍可点日、返回值也带 -01,根本没禁掉日逻辑。
value 初始化必须是合法日期字符串
laydate.render() 的 value 参数不能传 "2026" 或 "2026-06",否则控件可能不渲染、或静默回退到今天。
它底层按 Date 解析,所以:
-
type: "year"时,推荐value: "2026-01-01" -
type: "month"时,推荐value: "2026-06-01"
后端如果只返回 "2026-06",前端拼个 "-01" 再传进去即可,比如 value: backendMonth + "-01"。
想“一点即关”?得在 change 里手动删浮层
默认行为是:点完年份/月份后,还得点“确定”才赋值并关闭。要实现“点完立刻关”,必须在 change 回调里做两件事:
- 用
lay('#inputId').val(value)同步输入框 - 紧接着执行
$(".layui-laydate").remove()干掉浮层
别在 done 里做这事——done 是点“确定”后才触发;也别只改 val 却不删面板,否则用户再点别的年份,面板还在,值却已变,体验割裂。
min/max 要严格匹配 format 格式
min 和 max 必须是字符串,且格式要和 format 一致:
-
type: "year"+format: "yyyy"→min: "2020",max: "2026" -
type: "month"+format: "yyyy-MM"→min: "2020-01",max: "2026-12"
传 new Date() 或对象(如 {year: 2026, month: 5})会失效;动态更新要用 ins.set('min', '2026-06'),不是直接改 ins.config.min。
返回值仍是完整日期字符串(如 "2026-06-01"),前端若需纯年月,得自己截取:value.substring(0, 7),别指望控件自动省略日。











