Skip to content

InputTag 标签输入框

该组件是低代码平台中用于动态输入并管理多个标签(如关键词、标签列表) 的表单项,支持标签增删、拖拽排序、数量限制及样式定制,并深度集成表单容器(<el-form>)的数据绑定与校验体系。

基础属性

属性类型说明
是否支持一键清空 clearableboolean显示“×”按钮,点击清空所有标签(默认开启)
前缀图标 prefixIconstring显示在输入框左侧的图标(如 'ep:tag'
后缀图标 suffixIconstring显示在输入框右侧的图标
最多可添加标签数量 maxnumber限制用户可输入的最大标签数
是否折叠标签 collapseTagsboolean超出显示数量的标签折叠为“+N”形式
最多显示的标签数量 maxCollapseTagsnumber折叠前最多显示的标签数量(整数)
标签类型 tagTypeenum标签样式类型(如 primarysuccesswarning 等)
标签效果 tagEffectenum标签视觉效果(如 darklightplain
是否可以拖动标签 draggableboolean允许用户通过拖拽调整标签顺序
分隔符 delimiterstring输入时用于分割新标签的字符(如逗号 , 或空格)
是否自动获取焦点 autofocusboolean页面加载时自动聚焦到输入框
输入提示文本 placeholderstring未输入时的占位提示文字
表单项基础配置包含标签宽度、布局控制等通用表单项设置(来自 formItemBaseDefine

高级属性

属性类型说明
表单项高级配置包含字段名(prop)、标签文本(label)等核心绑定配置(来自 formItemAdvDefine

事件

事件触发时机说明
change标签列表发生变化时返回当前所有标签组成的数组