前端使用模糊搜索fuse.js和拼音搜索pinyin-match提升搜索体验

纯前端搜索常规实现就是字符串匹配(includes/indexOf), 使用模糊搜索和拼音搜索可以让搜索体验更好,模糊搜索推荐 fuse.js,拼音搜索推荐 pinyin-match。这两个库都不大,pinyin-match 27KB,fuse.js 不到20KB,体积负担不重,比起引入一个庞大的拼音库轻量很多。

如果再能高亮匹配字符就更完美了。模糊搜索fuse.js可以直接字符正则匹配替换,拼音搜索pinyin-match会返回位置信息,根据位置信息截取字符串即可。

以下是针对 Vue3 的实现代码:

js 复制代码
let Fuse;
let Pinyin;

const searchValue = ref('');
const list = ref([]);

const searchList = computed(() => {
  list.value.forEach(item => (item.titleSearch = void 0));
  if (!searchValue.value) return list.value;

  try {
    // 模糊搜索
    const fuse = new Fuse(list.value, {
      keys: ['title'],
      threshold: 0.5,
    });
    const fuseList = fuse.search(searchValue.value).map(m => {
      m.item.titleSearch = m.item.title.replace(new RegExp(`[${searchValue.value}]`, 'gi'), s => `<span class="search-target">${s}</span>`);
      return m.item;
    });
    // 拼音搜索
    const pinyinList = list.value.filter(m => {
      if (fuseList.find(f => f.objId === m.objId)) return false;
      const match = Pinyin.match(m.title, searchValue.value);
      if (match) {
        console.log(m.title, match);
        m.titleSearch = `${m.title.slice(0, match[0])}<span class="search-target">${m.title.slice(match[0], match[1] + 1)}</span>${m.title.slice(
          match[1] + 1
        )}`;
      }
      return match;
    });

    return fuseList.concat(pinyinList);
  } catch (error) {
    console.log(error);
    return list.value.filter(f => f.title.toLowerCase().includes(searchValue.value.toLowerCase()));
  }
});

onMounted(() => {
  importSearchLib();
})

function importSearchLib() {
  // 模糊搜索库,异步加载
  import('fuse.js')
    .then(module => {
      Fuse = module.default;
    })
    .catch(err => {
      console.log(err);
    });
  // 拼音搜索库,异步加载
  import('pinyin-match')
    .then(module => {
      Pinyin = module.default;
    })
    .catch(err => {
      console.log(err);
    });
}
  • list.value.forEach(item => (item.titleSearch = void 0)); 用于提前声明增加响应式属性 titleSearch,该字段是含高亮匹配字符的富文本。

  • return list.value.filter(f => f.title.toLowerCase().includes(searchValue.value.toLowerCase())); 错误回退机制,如果 fuse.js 或 pinyin-match 使用中报错了,回退到常规的字符串匹配(includes/indexOf)搜索。

  • importSearchLib() 异步加载 fuse.js 和 pinyin-match,虽然这两个库都不大,但搜索一般是用户主动触发,没必要在页面加载过程中引入,难免拖慢页面加载,上面的实现就是放到了 onMounted 钩子中等 DOM 装载完毕才去异步加载这两个库。

  • import('fuse.js') 如果出现如下语法格式化错误提醒:

Dynamic imports are only supported when the '--module' flag is set to 'es2020', 'es2022', 'esnext', 'commonjs', 'amd', 'system', 'umd', 'node16', 'node18', or 'nodenext'.ts-plugin(1323)

改一下 tsconfig.json 的配置即可:

json 复制代码
{
  "compilerOptions": {
    "module": "ES2020",
    "target": "ES2020",
  }
}
相关推荐
哈士奇冲鸭7 分钟前
实战:AG-Grid 在 qiankun 下的 CSS 命名空间隔离
前端
哈士奇冲鸭14 分钟前
实战:qiankun 微前端主题隔离,把 data-theme 从 html 挪进自己的容器
前端
疯华整猫15 分钟前
别再抄 Flutter 了:2026 年 Android / iOS / 小程序跨端架构选型的四本成本账
android·前端·ios
Warson_L16 分钟前
上传头像 (angular 16)
前端·angular.js
zhanlang021720 分钟前
HTML 零基础入门到企业实战【第七章 表单标签|7.1 表单核心作用:数据收集、用户交互原理】
前端·html·交互
FungLeo35 分钟前
成为全栈·Vue 管理后台篇·Biome、类型检查、构建和API 代理如何组成质量门禁
前端·javascript·vue.js·typescript·vite·前端工程化·biome
夕水1 小时前
受不了满屏广告的诗词网站,以及很多打不开的诗词网站,我干脆自己租服务器用trae重构了一个(纯公益、无广告)
前端·javascript
Brookty1 小时前
HTML基础知识:表格布局、表单数据提交、元素标识与资源相对路径
前端·html
徐小夕1 小时前
开源!我们用知识图谱重构了电子档案,AI 驱动全文智能关联
前端·vue.js·github
不一样的少年_2 小时前
用了这 Skill,前端兄弟都觉得好
前端·后端·ai编程