Mention 提及
规则
基础示例
Props 配置示例
自定义触发前缀(单字符)
选项字段映射
远程加载与 loading
整块删除提及
整段禁用
Events 事件示例
value:string,为输入框中的全文内容。
Props
| 名称 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| options | 提及选项列表 | array | [] |
| props | 选项字段配置 | object | { value: 'value', label: 'label', disabled: 'disabled' } |
| prefix | 触发前缀,长度必须为 1;可为多个单字符组成的数组 | string / array | '@' |
| split | 拆分提及的字符,长度必须为 1 | string | ' ' |
| filterOption | 自定义筛选逻辑;传 false 可关闭默认筛选 | boolean / Function | — |
| placement | 弹出位置 | string | 'bottom' |
| showArrow | 下拉是否有箭头 | boolean | false |
| offset | 面板偏移量 | number | 0 |
| whole | 退格时是否将提及作为整体删除 | boolean | false |
| checkIsWhole | 退格时是否按自定义逻辑判断整体删除 | Function | — |
| loading | 下拉是否处于加载态 | boolean | false |
| modelValue / value | 输入值 | string | — |
| popperClass | 浮层类名 | string / object | — |
| popperStyle | 浮层样式 | string / object | — |
| popperOptions | 浮层定位相关配置对象 | object | — |
| input props | 其余与内置输入框一致的属性(如 placeholder、disabled、clearable 等) | — | — |
Events
| 名称 | 说明 | 类型 |
|---|---|---|
| search | 按下触发前缀时触发 | Function |
| select | 用户选择某一选项时触发 | Function |
| whole-remove | 当整块移除提及且 whole 为 true 或 checkIsWhole 判定为整体删除时触发 | Function |
| input events | 输入框支持的其余事件名均可监听(如 focus、blur、change 等) | — |
Slots
| 名称 | 说明 |
|---|---|
| label | 自定义选项标签区域 |
| loading | 自定义加载展示 |
| header | 下拉列表顶部 |
| footer | 下拉列表底部 |
| (输入框插槽) | 与输入框一致的 prefix、suffix 等插槽名可用 |


