提及
用于在输入中提及某人或某事。
基本用法
最基本的用法。
道具 2.11.3
您可以通过props属性自定义options的别名。
文本区域
输入类型可设置为textarea。
自定义标签
通过label插槽定制标签。
加载远程选项
异步加载选项。
自定义触发令牌
通过 prefix 道具自定义触发令牌。默认为@,也支持Array<string>。
整体删除
将whole属性设置为true,当你按退格键时,提及将被整体删除。 设置check-is-whole属性来自定义检查逻辑。
使用表单
与 el-form 一起使用。
TIP
由于该组件是基于组件 el-input 开发的,所以原有的属性没有改变,所以这里不再重复, 请前往原始组件查看文档。
API
属性
| 名称 | 描述 | 类型 | 默认 |
|---|---|---|---|
| 选项 | 提及选项列表 | 数组 | [] |
| 道具 2.11.3 | 配置选项 | 对象 | {value: 'value', label: 'label', disabled: 'disabled'} |
| 前缀 | 触发提及的前缀字符。字符串长度必须恰好为 1 | 字符串 | 数组 | '@' |
| 分裂 | 用于分割提及的字符。字符串长度必须恰好为 1 | 字符串 | ' ' |
| 过滤选项 | 自定义过滤选项逻辑 | 假 | 功能 | — |
| 安置 | 设置弹出位置 | 字符串 | 'bottom' |
| 显示箭头 | 下拉面板是否有箭头 | 布尔值 | false |
| 偏移 | 下拉面板的偏移量 | 数字 | 0 |
| 整体 | 按退格删除时提及内容是否整体删除 | 布尔值 | false |
| 检查是否完整 | 当按退格删除时,检查提及是否是一个整体 | 功能 | — |
| 加载 | 提及的下拉面板是否处于加载状态 | 布尔值 | false |
| 模型值 / v 模型 | 输入值 | 字符串 | — |
| 波普尔级 | 下拉面板的自定义类名 | 字符串 / 对象 | '' |
| 波普风格 2.11.5 | 下拉面板的自定义样式 | 字符串 / 对象 | — |
| popper 选项 | popper.js 参数 | object 参考popper.js doc | — |
| 输入道具 | — | — | — |
活动
| 名称 | 描述 | 类型 |
|---|---|---|
| 搜索 | 当前缀命中时触发 | 功能 |
| 选择 | 当用户选择选项 | 时触发功能 |
| 整体删除 2.10.4 | 当删除整个提及且 whole 为 true 或 check-is-whole 为 true 时触发 | 功能 |
| 输入事件 | — | — |
老虎机
| 名称 | 描述 | 类型 |
|---|---|---|
| 标签 | 内容作为选项标签 | 对象 |
| 加载 | 内容作为选项加载 | — |
| 标题 | 下拉菜单顶部的内容 | — |
| 页脚 | 下拉菜单底部的内容 | — |
| 输入插槽 | — | — |
暴露
| 名称 | 描述 | 类型 |
|---|---|---|
| 输入 | el-input 组件实例 | 对象 |
| 工具提示 | el-tooltip 组件实例 | 对象 |
| 下拉可见 2.8.5 | 工具提示显示状态 | 对象 |
类型声明
显示声明
ts
type MentionOption = {
value?: string
label?: string
disabled?: boolean
[key: string]: any
}
type MentionOptionProps = {
value?: string
label?: string
disabled?: string
[key: string]: string | undefined
}