Mention 提及
用于在输入框中提及某人或某事。
基础用法
最基础的用法。
文本域
输入框类型可以设置为 textarea
。
自定义选项标签
通过 label
插槽来自定义选项标签。
远程加载选项
异步加载选项。
自定义触发符号
通过 prefix
属性自定义触发符号。 默认为 @
,也支持 Array<string>
。
整体删除
将 whole
属性设置为 true
,当您按下退格键时,提及的内容将被整体删除。 设置 check-is-whole
属性可自定义检查逻辑。
配合表单使用
配合 el-form
使用。
提示
由于该组件是在 el-input
组件的基础上开发的,原有属性没有变化,这里不再赘述,请到原组件查看文档。
API
属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
options | 提及选项列表 | array | [] |
prefix | 用于触发提及的前缀字符。 字符串长度必须为 1 | string | array | '@' |
分隔 | 用于分隔提及的字符。 字符串长度必须为 1 | string | ' ' |
过滤选项 | 自定义筛选选项逻辑 | false | Function | — |
placement | 设置弹出位置 | string | 'bottom' |
show-arrow | 下拉面板是否有箭头 | boolean | false |
offset | 下拉面板的偏移量 | number | 0 |
整体 | 按退格键删除时,提及内容是否整体删除 | boolean | false |
检查是否整体 | 按退格键删除时,检查提及是否为整体 | Function | — |
加载中 | 提及的下拉面板是否处于加载状态 | boolean | false |
model-value / v-model | 输入框的值 | string | — |
popper-class | 下拉面板的自定义类名 | string | — |
popper-options | popper.js 参数 | object 参见 popper.js 文档 | — |
input 属性 | — | — | — |
事件
名称 | 描述 | 类型 |
---|---|---|
搜索 | 当命中前缀时触发 | Function |
select | 当用户选择选项时触发 | Function |
整体移除 2.10.4 | 当 whole 为 true 或 check-is-whole 为 true 时,当整个提及被移除时触发 | Function |
输入框事件 | — | — |
插槽
名称 | 描述 | 类型 |
---|---|---|
label | 内容作为选项标签 | object |
加载中 | 内容作为选项加载中 | — |
header | 下拉列表顶部的内容 | — |
footer | 下拉列表底部的内容 | — |
输入框插槽 | — | — |
暴露
名称 | 描述 | 类型 |
---|---|---|
input | el-input 组件实例 | object |
提示 | el-tooltip 组件实例 | object |
下拉菜单可见性 2.8.5 | 提示显示状态 | object |
类型声明
显示声明
ts
type MentionOption = {
value: string
label?: string
disabled?: boolean
[key: string]: any
}