讲师中心 微信公众号
AI工具推荐 视频效率加速

Vue 3 中自定义表单组件怎么实现可搜索的多选标签

冬强同学_6168

冬强同学_6168

发布时间:2026-10-05 07:47:18

|

114人浏览过

|

来源于php中文网

原创

Vue 3 可搜索多选标签组件需协同搜索过滤、多选状态管理与标签渲染控制,推荐基于 Element Plus 或 Ant Design Vue 封装:前者适用于扁平选项,后者适配树形结构;应统一收口逻辑,支持防抖加载、键盘导航及无障碍访问。

vue 3 中自定义表单组件怎么实现可搜索的多选标签

Vue 3 中实现可搜索的多选标签表单组件,核心在于“搜索过滤 + 多选状态管理 + 标签渲染控制”三者协同。不需要从零造轮子,而是基于成熟 UI 库(如 Element Plus、Ant Design Vue 或 Vue 3 Multiselect)做合理封装与定制。

用 Element Plus 的 el-select 实现基础多选+搜索

Element Plus 的 el-select 原生支持多选(multiple)、搜索(filterable)、标签折叠(collapse-tags)和自定义标签展示(tag 插槽):

  • 开启 filterable 后,输入时自动按 label 过滤选项;如需更灵活匹配(比如搜索 value 或描述字段),可配合 :filter-method 自定义逻辑
  • 设置 :max-collapse-tags="1" 控制最多显示几个标签,超出后显示 +N;也可用 max-tag-count 和 max-tag-placeholder 精确控制省略行为
  • 通过 v-slot:tag="{ item }" 可渲染带图标的标签,例如显示部门图标 + 名称,或添加删除按钮

用 Ant Design Vue 的 TreeSelect 支持树形结构下的搜索多选

当选项有层级关系(如地区、组织架构),推荐用 a-tree-select:

vue-component-analyzer
vue-component-analyzer

递归分析 Vue 项目组件依赖,从入口文件生成组件层级图,支持 Vue 2/3,输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。

下载
  • 启用 show-search 并配置 filterTreeNode,让搜索穿透到子节点;配合 tree-node-filter-prop="title" 指定搜索字段
  • 开启 multiple 和 tree-checkable,即可多选节点;选中项以 tag 形式展示在输入框内
  • 为提升体验,可加高亮:在 tree-node-label 插槽中用 v-html 渲染带 <mark> 的搜索关键词,需提前对 title 做字符串高亮处理

封装成可复用的自定义组件(推荐做法)

把搜索逻辑、选项加载、选中状态、标签样式统一收口,对外只暴露 v-model 和少量 props:

立即学习“前端免费学习笔记(深入)”;

  • 接收 options(数组)或 fetchOptions(函数),支持本地静态数据或远程分页/搜索加载
  • 暴露 search-key prop,指定搜索时比对的字段名(如 "label" 或 "name"),内部自动做模糊匹配
  • 标签区域使用 v-for 渲染,每个 tag 显示简短标识(如首字母缩写),hover 展示完整文本;支持点击删除单个标签
  • 加 clearable 和 reserve-keyword 配合,确保搜索后清空仍能恢复全部选项

注意交互细节,避免常见坑

真实项目中容易忽略但影响体验的关键点:

  • 搜索时,如果选项是异步加载的,要防抖(debounce)请求,避免频繁触发接口
  • 多选后下拉面板不要自动关闭,方便连续操作;可用 @visible-change 控制显隐逻辑
  • 键盘操作要完整:支持 Enter 确认搜索、Backspace 删除最后一个 tag、ArrowDown/Up 在选项间导航
  • 无障碍方面,确保 aria-live 提示已选数量,role="combobox" 正确声明组件语义

热门AI工具

更多
超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

2263

2023.08.11

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

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

4883

2023.10.09

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

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

5990

2024.03.19

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

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

5478

2024.03.22

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

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

783

2024.05.22

ECharts是什么
ECharts是什么

ECharts是基于JavaScript的开源可视化库,能够帮助开发者轻松地实现各种复杂的数据可视化效果,提供了丰富的图表类型和交互功能。本专题为大家提供ECharts是什么的相关的文章、下载、课程内容,供大家免费下载体验。

772

2023.08.04

echarts自适应大小设置
echarts自适应大小设置

使用ECharts的自适应大小设置可以使图表能够根据不同屏幕尺寸和设备进行自适应。一种是使用resize事件,在图表容器大小改变时重新渲染图表;另一种是使用CSS样式,通过设置图表容器的宽度和高度为百分比值,使图表容器根据父元素的大小进行自适应。根据实际需求选择合适的方法,可以使图表在不同设备上都能够良好地显示和交互 。

4125

2023.09.13

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

1634

2023.07.17

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 16.9万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn