Skip to content

Props

名称类型默认值说明
default-fieldstring--自定义按下 enter 键时,默认搜索的范围;此属性为空时。则默认在关键字范围下搜索 xxx,即生成的搜索标签为“关键字:xxx”
editablebooleanfalse是否开启标签编辑功能,(注:map 类型不支持编辑)
empty-placeholderstring默认按照关键字搜索没有筛选项时的占位文本
id-map-keystring--配置用来识别筛选项的 id 键取值来源,默认取 props.items 数据的 id,一般用于接口返回的 props.items 数据字段不匹配,但是又需要其中一个键值来识别筛选项的情况;注意:不建议使用 label/value/field 等字段,会被覆盖
itemsISearchBoxItem[][]数据项
maxlengthnumber--input 元素的原生属性,限制输入框的长度,可配合 exceed 监听输入超出限定长度的事件
model-value/v-modelISearchBoxTag[][]选中的标签列表
panel-max-heightstring999px设置下拉面板最大高度
potential-optionsgetMatchList: (arg1: string) => ISearchBoxMatchItem[]{}潜在项匹配,接口返回潜在匹配项的数据列表,异步或同步皆可
show-helpbooleantrue是否显示帮助图标。3.14.0 及以上版本默认显示;低于此版本默认隐藏
show-no-data-tipbooleantrue控制显隐面板的无数据提示
split-input-valuestring,用于指定字符串,将输入值拆分成多个关键字,一次性生成多个标签,默认用英文逗号 "," 分隔