InputTag 标签输入框
该组件是低代码平台中用于动态输入并管理多个标签(如关键词、标签列表) 的表单项,支持标签增删、拖拽排序、数量限制及样式定制,并深度集成表单容器(<el-form>)的数据绑定与校验体系。
基础属性
| 属性 | 类型 | 说明 |
|---|---|---|
是否支持一键清空 clearable | boolean | 显示“×”按钮,点击清空所有标签(默认开启) |
前缀图标 prefixIcon | string | 显示在输入框左侧的图标(如 'ep:tag') |
后缀图标 suffixIcon | string | 显示在输入框右侧的图标 |
最多可添加标签数量 max | number | 限制用户可输入的最大标签数 |
是否折叠标签 collapseTags | boolean | 超出显示数量的标签折叠为“+N”形式 |
最多显示的标签数量 maxCollapseTags | number | 折叠前最多显示的标签数量(整数) |
标签类型 tagType | enum | 标签样式类型(如 primary、success、warning 等) |
标签效果 tagEffect | enum | 标签视觉效果(如 dark、light、plain) |
是否可以拖动标签 draggable | boolean | 允许用户通过拖拽调整标签顺序 |
分隔符 delimiter | string | 输入时用于分割新标签的字符(如逗号 , 或空格) |
是否自动获取焦点 autofocus | boolean | 页面加载时自动聚焦到输入框 |
输入提示文本 placeholder | string | 未输入时的占位提示文字 |
| 表单项基础配置 | — | 包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine) |
高级属性
| 属性 | 类型 | 说明 |
|---|---|---|
| 表单项高级配置 | — | 包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine) |
事件
| 事件 | 触发时机 | 说明 |
|---|---|---|
change | 标签列表发生变化时 | 返回当前所有标签组成的数组 |
