Mention 提及
用于在输入中提及某人或某事。
基础用法
最简单的用法。
Textarea
输入类型可以设置为 textarea
。
自定义标签
使用 "label" 自定义标签。
加载远程选项
异步加载选项。
自定义触发字段
通过 prefix
属性 自定义触发字段。 默认为 @
, Array<string>
。
整体删除
将whole
属性设置为 true
,当您按下退格键时,此处的 mention 区域将作为一个整体被删除。 设置 "check-is-whole" 属性来自定义检查逻辑。
在表单里使用
与 el-form
一起使用
TIP
由于这个组件是基于el-input
派生的,他们的原始属性未被更改,故不在此重复。请跳转查看原组件的相应文档。
API
属性
名称 | 说明 | 类型 | 默认值 |
---|---|---|---|
options | 提及选项列表 | array | [] |
prefix | 触发字段的前缀。 字符串长度必须且只能为 1 | string | array | '@' |
split | 用于拆分提及的字符。 字符串长度必须且只能为 1 | string | ' ' |
filter-option | 定制筛选器选项逻辑 | false | Function | — |
placement | 设置弹出位置 | string | 'bottom' |
show-arrow | 下拉菜单的内容是否有箭头 | boolean | false |
offset | 下拉面板偏移量 | number | 0 |
whole | 当退格键被按下做删除操作时,是否将提及部分作为整体删除 | boolean | false |
check-is-whole | 当退格键被按下做删除操作时,检查是否将提及部分作为整体删除 | Function | — |
loading | 提及的下拉面板是否处于加载状态 | boolean | false |
model-value / v-model | 输入值 | string | — |
popper-class | 自定义浮层类名 | string | — |
popper-options | popper.js 参数 | object refer to popper.js doc | — |
input props | — | — | — |
事件
名称 | 说明 | 类型 |
---|---|---|
search | 按下触发字段时触发 | Function |
select | 当用户选择选项时触发 | Function |
input events | — | — |
Slots
名称 | 说明 | 类型 |
---|---|---|
label | 自定义标签内容 | object |
loading | 自定义 loading内容 | — |
header | 下拉列表顶部的内容 | — |
footer | 下拉列表底部的内容 | — |
input slots | — | — |
Exposes
名称 | 说明 | 类型 |
---|---|---|
input | el-input 组件实例 | object |
tooltip | el-tooltip 组件实例 | object |
dropdownVisible 2.8.5 | tooltip 显示状态 | object |
类型声明
Show declarations
ts
type MentionOption = {
value: string
label?: string
disabled?: boolean
[key: string]: any
}