必须使用 form.on('select(filter)') 监听下拉框变化,filter 值须与 lay-filter 属性完全一致;select 需包裹在 layui-form 容器内,动态加载后须调用 form.render('select'),设置值需配合 form.val() 和 form.render() 成对执行。
必须用 form.on('select(filter)'),原生 change 无效
layui 把原始 <select> 隐藏了,替换成 <div><ul><li> 结构,所有交互都走内部逻辑。你给原生元素绑 addeventlistener('change') 或 jquery 的 .on('change'),根本监听不到——它压根没触发。
唯一有效方式是:form.on('select(filter)'),其中 filter 必须和 HTML 中 select 的 lay-filter 属性值完全一致(大小写、空格、下划线都不能错)。
-
select必须包裹在class="layui-form"的容器内,否则form模块不接管,监听直接失效 - 如果
select是 AJAX 加载后动态插入的,必须手动调用form.render('select'),否则form.on不会响应 - 别把
radio的写法套过来:form.on('radio(filter)')和form.on('select(filter)')是两个事件名,混用就静默失败
data.value 是你要的值,别碰 data.elem.value
回调函数里的 data 不是原生 event,而是 Layui 封装对象。最常需要的字段只有三个:
-
data.value:当前选中的 option 的value属性值(字符串),直接用,准没错 -
data.elem:原始<select>DOM 元素,可用于读写name、disabled等属性,但data.elem.value或$(data.elem).val()返回的往往是空或旧值 -
data.othis:渲染后的美化下拉框 DOM(就是你看到的那个带箭头的盒子),可用于定位、加样式等
常见错误:在回调里写 console.log(data.elem.value),结果打印 undefined 或上一次的值——这是踩坑最多的地方。
动态更新选项后,漏掉 form.render('select') 就白干
比如第一个 select 选中后,用 AJAX 拉第二个 select 的选项,然后用 .html() 替换 <option> 列表。这时新内容只是纯 HTML,Layui 并不知道它变了。
- 替换完 HTML 后,必须立刻执行
form.render('select') - 如果页面有多个 select,只想重绘某一个,可以传选择器:
form.render('select', '#mySelectId')或更推荐传lay-filter值:form.render('select', 'myFilterName') - 漏掉这步的现象是:选项看着有了,但点不动、不触发
form.on、提交时该字段为空
代码触发 change 事件:必须 form.val() + form.render('select') 成对出现
不能直接操作原生 select 的 value,也不能用 dispatchEvent(new Event('change')) —— Layui 的事件监听器根本没注册在原生元素上。
- 正确做法:先用
form.val('filterName', { 'fieldName': 'newValue' })设置值,再调用form.render('select', 'filterName') -
form.val()的第一个参数是lay-filter值,第二个参数是对象,key 是select的name属性名 - 最容易被忽略的是 render 步骤:很多人只设值就以为完事了,结果监听函数根本没执行
复杂点在于,Layui 的事件流不是单向同步的——set value 和 render 是两个独立动作,缺一不可,且 render 的 type 参数必须明确写成 'select',不能省略或写错。


















