
lay-filter 是事件监听的“身份证”
它不是样式控制或数据绑定属性,而是 layui 事件系统用来定位目标元素的唯一标识。没有它,form.on() 就不知道该响应哪个下拉框的改变。
下拉框必须加 lay-filter 才能监听 change 事件
原生 的 change 事件在 layui 中被封装进 form.on('select(filterName)', ...),而这个 filterName 就来自 lay-filter 的值。
- 不写
lay-filter→form.on('select(xxx)')完全收不到事件 - 多个
写了相同的lay-filter值 → 所有下拉框共用一个监听函数,无法区分来源 - 值含空格、特殊符号(如
user-select)没问题,但建议只用字母、数字、短横线
和 lay-search、name 属性的关系容易混淆
lay-search 只是开启搜索框功能,不影响事件绑定;name 属性在表单提交时有用,但 form.on('select(...)') 不看它——只认 lay-filter。
- 常见错误:写了
name="category"就以为form.on('select(category)', ...)能触发 → 实际不会 - 正确写法:
+form.on('select(category)', ...) - 如果用了
lay-search,选中项仍会正常触发select事件,无需额外处理
多级联动时 lay-filter 命名要体现层级关系
比如省市区三级下拉,别全用 lay-filter="area",否则事件里分不清是哪一级变了。
- 推荐命名:
lay-filter="province"、lay-filter="city"、lay-filter="district" - 这样每个
form.on('select(province)', ...)可以独立写加载城市的逻辑 - 注意:layui 不自动做级联,
lay-filter只负责把事件送到对应函数,后续请求、重绘都得你手动写
实际开发中最容易忽略的是:**lay-filter 值必须和 form.on() 里的字符串完全一致,大小写敏感,且不能有前后空格**。复制粘贴时多一个空格,事件就静默失效,控制台还不报错。











