Mention 提及

用于在输入框中提及某人或某事。

基础用法

最基础的用法。

文本域

输入框类型可以设置为 textarea

自定义选项标签

通过 label 插槽来自定义选项标签。

远程加载选项

异步加载选项。

自定义触发符号

通过 prefix 属性自定义触发符号。 默认为 @,也支持 Array<string>

整体删除

whole 属性设置为 true,当您按下退格键时,提及的内容将被整体删除。 设置 check-is-whole 属性可自定义检查逻辑。

配合表单使用

配合 el-form 使用。

名称
描述

提示

由于该组件是在 el-input 组件的基础上开发的,原有属性没有变化,这里不再赘述,请到原组件查看文档。

API

属性

名称描述类型默认值
options提及选项列表array[]
prefix用于触发提及的前缀字符。 字符串长度必须为 1string | array'@'
分隔用于分隔提及的字符。 字符串长度必须为 1string' '
过滤选项自定义筛选选项逻辑false | Function
placement设置弹出位置string'bottom'
show-arrow下拉面板是否有箭头booleanfalse
offset下拉面板的偏移量number0
整体按退格键删除时,提及内容是否整体删除booleanfalse
检查是否整体按退格键删除时,检查提及是否为整体Function
加载中提及的下拉面板是否处于加载状态booleanfalse
model-value / v-model输入框的值string
popper-class下拉面板的自定义类名string
popper-optionspopper.js 参数object 参见 popper.js 文档
input 属性

事件

名称描述类型
搜索当命中前缀时触发Function
select当用户选择选项时触发Function
整体移除 2.10.4wholetruecheck-is-wholetrue 时,当整个提及被移除时触发Function
输入框事件

插槽

名称描述类型
label内容作为选项标签object
加载中内容作为选项加载中
header下拉列表顶部的内容
footer下拉列表底部的内容
输入框插槽

暴露

名称描述类型
inputel-input 组件实例object
提示el-tooltip 组件实例object
下拉菜单可见性 2.8.5提示显示状态object

类型声明

显示声明
ts
type MentionOption = {
  value: string
  label?: string
  disabled?: boolean
  [key: string]: any
}

来源

组件样式文档

贡献者