项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

AutoComplete 输入联想 ​

输入联想组件:静态候选自动前缀过滤,或经 fetch-suggestions 异步取数(内置防抖与过期响应丢弃)。键盘 ↑↓ 移动高亮、Enter 选中、Esc 关闭。候选支持字符串 / 数字 / { value, label? } 对象(显示 label,回退 value);有输入且无结果时展示「无匹配数据」空态行(文案随语言包);输入框带 combobox / listbox / aria-activedescendant 无障碍语义。

静态候选 ​

当前值:—

异步联想 ​

候选字段与默认高亮 ​

候选为 { value, label? } 对象时展示 label、回退 value,选中仍回填 value;default-active-first-option 开启后结果更新自动高亮第一条(antd 默认 true,本组件默认 false),Enter 直接选中。

当前值:—

空态提示 ​

有输入但无匹配结果时,面板内展示「无匹配数据」空态行(取语言包 select.noMatch),随 ConfigProvider 语言切换;清空输入或匹配到结果后自动恢复候选列表。

AutoComplete API ​

Props ​

名称类型默认值说明
modelValueString / Number—绑定值
suggestionsArray—静态候选:string / number 或 { value, label? }(展示 label 回退 value)
fetch-suggestionsFunction—(query, cb) => void 异步联想
filterableBooleantrue静态候选本地过滤开关(按 value 匹配)
debounceNumber200输入防抖(ms),组件卸载时自动清理挂起定时器
minlengthNumber0触发联想最小字符数
default-active-first-optionBooleanfalse结果更新自动高亮第一条(antd 默认 true),Enter 直接选中
value-on-selectBooleantrue选中后回填输入框
input-propsObject{}透传内部 EbInput(placeholder / size / disabled…)
rippleBooleantrue激活涟漪动效开关:聚焦时实体色影向内收拢消散;也可在 Form 上批量关闭或全局 setRipple(false)

事件 ​

名称说明
select选中候选,参数 (item, index)
suggest发起联想
clear值被清空

插槽 ​

option({ item })自定义候选项内容;未声明的 attrs 直接透传内部输入框。

Mention 提及 ​

多行输入框的 @ 提及:输入 @ 弹出候选(镜像 div 测量光标坐标定位),支持键盘选择,选中后以 @xxx 回填。

基础用法 ​

内容:—

Mention API ​

名称类型默认值说明
modelValueString—内容
optionsArray[]候选成员
prefixString@触发前缀
splitString空格选中后分隔符
rowsNumber3行数

事件:select、search(query, prefix)(可在此接入远程成员搜索)。