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

冬强同学_6168

冬强同学_6168

2026-10-05

114人浏览

原创

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></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" 正确声明组件语义

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

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

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

下载

相关标签:

vue.js vue vue 3

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

相关专题

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

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

2023.08.11

2263

5

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

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

2023.10.09

4883

6

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

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

2024.03.19

5970

13

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

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

2024.03.22

5458

10

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

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

2024.05.22

783

5

ECharts是什么
ECharts是什么

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

2023.08.04

772

5

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

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

2023.09.13

4125

8

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

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

2023.07.17

1634

5

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

11842

5

热门下载

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

精品课程

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

共42课时 | 16.9万人学习

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

共12课时 | 1.4万人学习

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

共18课时 | 1.7万人学习