用于在输入中提及某人或某事,常用于发布、聊天或评论功能。
指定 prefix 来自定义触发字符。默认为 @,可以自定义为任意字符。
| 参数名 |
描述 |
类型 |
默认值 |
版本 |
| model-value (v-model) |
绑定值 |
string |
- |
|
| default-value |
默认值(非受控状态) |
string |
'' |
|
| data |
用于自动补全的数据 |
(string | number | SelectOptionData | SelectOptionGroup)[] |
[] |
|
| prefix |
触发自动补全的关键字 |
string | string[] |
'@' |
|
| split |
选中项的前后分隔符 |
string |
' ' |
|
| type |
输入框或文本域 |
'input' | 'textarea' |
'input' |
|
| disabled |
是否禁用 |
boolean |
false |
|
| allow-clear |
是否允许清空输入框 |
boolean |
false |
2.23.0 |
| fit-width |
宽度是否适应文字内容 |
boolean |
false |
|
| max-w-full |
最大宽度是否限制为父容器宽度 |
boolean |
true |
|
| 事件名 |
描述 |
参数 |
版本 |
| change |
值发生改变时触发 |
value: string |
|
| search |
动态搜索时触发,2.47.0 版本增加 prefix 参数 |
value: string prefix: string |
|
| select |
选择下拉选项时触发 |
value: string | number | Record<string, any> | undefined |
|
| clear |
用户点击清除按钮时触发 |
- |
2.23.0 |
| focus |
文本框获取焦点时触发 |
ev: FocusEvent |
2.42.0 |
| blur |
文本框失去焦点时触发 |
ev: FocusEvent |
2.42.0 |
| 方法名 |
描述 |
参数 |
返回值 |
版本 |
| focus |
使输入框获取焦点 |
- |
- |
2.24.0 |
| blur |
使输入框失去焦点 |
- |
- |
2.24.0 |
| 插槽名 |
描述 |
参数 |
版本 |
| option |
选项内容 |
data: OptionInfo |
2.13.0 |