layui下拉框如何实现拼音搜索功能

星明大大_5079

星明大大_5079

2026-08-14

397人浏览

原创

layui下拉框原生不支持拼音搜索,需手动集成拼音库(如pinyin-pro)并缓存选项拼音,监听搜索输入事件实现拼音匹配。

layui下拉框如何实现拼音搜索功能

layui 下拉框默认不支持拼音搜索

原生 layui.select 和 layui.form.render('select') 渲染的下拉框,只支持精确匹配或模糊匹配(基于 option 的 text 内容),不识别中文拼音。用户输入“zhang”,不会命中“张三”“章伟”这类选项——这不是配置没开,是底层压根没做拼音转换逻辑。

必须自己加拼音转换 + 自定义搜索过滤

核心思路是:拦截 select 的搜索输入事件 → 把用户输入转成拼音 → 遍历所有 option 文本,把它们也转成拼音 → 做 indexOf 匹配。Layui 的 select 组件在开启 search="true" 后会生成一个带 input 的搜索框,其 class 为 layui-select-search,可以监听它的 input 事件。

实操建议:

  • 用轻量拼音库如 pinyin-pro(推荐)或 js-pinyin,避免引入完整 lodash-chinese 这类大包;pinyin-pro 支持多音字可选、体积小、无依赖
  • 预先为每个 option 缓存拼音值,避免每次搜索都重复转换(尤其数据量 >50 条时明显卡顿)
  • 注意 select 是动态渲染的:要等 form.render() 完成后再绑定事件,否则 DOM 找不到搜索框
  • 匹配时别只比对 text,还要考虑 value(比如后端返回的是 ID,但搜索希望按姓名搜)

示例关键代码片段:

// 初始化后执行
layui.use(['form', 'jquery'], function() {
  var form = layui.form,
      $ = layui.jquery;

  // 等待 select 渲染完成
  setTimeout(function() {
    var $search = $('.layui-select-search input');
    var $options = $('select[name="user"] option');

    // 预计算拼音缓存
    var pinyinCache = {};
    $options.each(function() {
      var text = $(this).text().trim();
      if (text) {
        pinyinCache[text] = pinyinPro(text, { type: 'first' }); // 或 'all'
      }
    });

    $search.on('input', function() {
      var kw = $(this).val().trim();
      if (!kw) return;

      var pinyinKw = pinyinPro(kw, { type: 'first' });
      $options.hide();
      $options.filter(function() {
        var text = $(this).text().trim();
        var pinyinText = pinyinCache[text] || '';
        return pinyinText.indexOf(pinyinKw) > -1 || text.indexOf(kw) > -1;
      }).show();
    });
  }, 100);
});

注意 layui 版本与 DOM 更新时机

Layui 2.8+ 对 select 搜索做了封装,但依然不暴露拼音接口。如果你用的是异步加载 option(比如 ajax 动态填充),必须在 $.get(...).done() 里重新构建 pinyinCache 并重绑事件——否则新加载的选项永远搜不到。

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载

常见错误现象:

  • 输入拼音能搜,但回车或点击没反应 → 因为只改了 display,没同步更新 lay-select 的内部高亮逻辑;建议配合 form.val('filterName', value) 主动触发选中
  • 搜索框失焦后结果消失 → 原因是 layui 默认在 blur 时重置下拉面板,需用 return false 阻止默认行为,或改用自定义下拉面板(更重,但可控)
  • 移动端软键盘收起后搜索失效 → 监听 blur 后手动触发一次 input 事件补救

拼音库选型和性能取舍点

pinyin-pro 和 js-pinyin 表现差异主要在:

  • pinyin-pro:支持 { type: 'all' } 输出全拼(“zhāng sān”)、'first'(“zs”)、'last'(“san”),且自带去空格/标点预处理,适合搜索场景
  • js-pinyin:更老,不支持多音字上下文,但体积更小(~4KB);若业务中姓名基本无多音字,它够用
  • 千万别用运行时调接口查拼音(如百度 API)——延迟高、不稳定、有调用限额

如果下拉选项超过 200 条,建议加防抖(setTimeout + clearTimeout),否则每敲一个字都触发全量拼音比对,iOS Safari 上容易卡死。

真正麻烦的不是加拼音,而是让 layui 的 select 在自定义过滤后还能保持原有的交互反馈(如 hover 高亮、回车确认、键盘上下键导航)。这些需要 patch 它的内部方法,或者直接换用 laytpl + dropdown 自研下拉——但那就不是“layui 下拉框”了。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2323

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5023

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6090

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5618

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

803

5

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2035

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2982

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1016

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3359

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.7万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习