layui select 默认不支持搜索,需通过 lay-search 属性启用内置搜索逻辑;该属性为布尔型,写上即生效,仅作用于 标签,匹配 option 文本内容且不区分大小写。

layui select 默认不支持搜索,必须手动启用
layui 的 select 组件原生不带搜索功能,所谓“开启”其实是通过 lay-search 属性触发内置的搜索逻辑。没加这个属性,下拉框就只是纯选择,输字符不会过滤选项。
-
lay-search是布尔属性,写上即生效,无需赋值(lay-search=""或lay-search="true"都行,但推荐不带等号) - 只对
<select></select>标签生效,对通过 JS 动态渲染的select也有效,前提是初始化前 HTML 中已存在该属性 - 搜索匹配的是
<option></option>的文本内容(innerText),不是value,也不区分大小写 - 如果
select含有disabled选项,它们仍会参与搜索匹配,但不可选中
为什么加了 lay-search 还没反应?检查这几点
常见失效原因不是配置错,而是初始化或 DOM 状态问题:
- HTML 中写了
lay-search,但后续又用 JS 调用form.render()时没传类型参数——应显式调用form.render('select'),否则可能漏掉新添加的带搜索属性的 select - select 是异步加载的(比如 AJAX 填充 option 后才插入 DOM),需在插入完成后立即调用
form.render('select'),不能依赖页面初始渲染 - 使用了自定义模板(
templet)或开启了filter事件并阻止了默认行为,会覆盖搜索逻辑,此时搜索功能自动失效 - layui 版本低于 2.6.0 ——
lay-search在 2.6.0 才正式稳定支持,旧版可能仅部分生效或报错Uncaught TypeError: Cannot read property 'indexOf' of undefined
搜索体验优化:禁用模糊匹配、限制最小输入长度
layui 默认是“包含匹配”,输入“北”会命中“北京”“河北”“东北”。如需精确开头匹配,或避免单字触发过多结果,得自己干预:
- 无法通过配置关闭模糊匹配,但可在
form.on('select(filterName)')中监听,配合select.val()做二次校验,不符合规则则手动清空并提示 - 想实现“至少输 2 个字才开始搜索”,layui 不提供钩子,需重写下拉面板逻辑——更实际的做法是用
input+dl自建搜索下拉(即放弃原生 select),用laytpl渲染 +jquery.typeahead类库辅助 - 移动端下
lay-search的输入框焦点易被键盘遮挡,建议在focus事件里加setTimeout(() => window.scrollTo(0, 0), 100)强制滚动到顶部
和 layUI 3.x / layui-vue 混用时的兼容风险
如果你项目里同时用了 layui 2.x 和 layui-vue(或计划升级),注意:lay-search 是 layui 2.x 专属属性,在 layui-vue 的 <lv-select></lv-select> 中无效,且其搜索逻辑完全不同(基于 filterable prop 和 remote 方法)。混用时容易误以为“都叫 select 就该一样”,结果搜索行为不一致甚至报错 form is not defined。
真正要跨版本复用搜索能力,得剥离 UI 层,把选项数据、搜索函数、高亮逻辑抽成独立模块,再分别接入不同组件的事件流。这点很多人一开始没意识到,直到上线后用户反馈“手机搜不了”才回头查。











