Skip to content

AutoComplete 自动补全输入框

规则

基础示例

Props 配置示例

支持清除 + 受控展开

搜索联动动态更新 options

整段禁用

尺寸对比(小 / 中 / 大)

Events 事件示例

监听选择与输入变化

参考:Antdv Next AutoComplete

value: string

Props

参数说明类型默认值版本
allowClear支持清除boolean |false-
backfill使用键盘选择选项的时候把选中项回填到输入框中booleanfalse-
classes用于自定义组件内部各语义化结构的 class,支持对象或函数Record<SemanticDOM, string> | (info: { props }) => Record<SemanticDOM, string>--
defaultActiveFirstOption是否默认高亮第一个选项booleantrue-
disabled是否禁用booleanfalse-
getPopupContainer菜单渲染父节点(triggerNode: HTMLElement) => HTMLElement() => document.body-
labelRender自定义当前选中的 label 内容 render(props: LabelInValueType) => VueNode--
notFoundContent当下拉列表为空时显示的内容VueNode--
open是否展开下拉菜单boolean--
options数据化配置选项内容{ label: VueNode; value: string }[]--
optionRender自定义下拉选项渲染(option: FlattenOptionData<BaseOptionType>, info: { index: number }) => VueNode--
placeholder输入框提示string--
popupMatchSelectWidth下拉菜单和选择器同宽boolean | numbertrue-
popupRender自定义下拉框内容(menu: VueNode) => VueNode--
showSearch搜索配置boolean | SearchConfigtrue-
size控件大小large | middle | small--
status设置校验状态error | warning--
styles用于自定义组件内部各语义化结构的行内 style,支持对象或函数Record<SemanticDOM, CSSProperties> | (info: { props }) => Record<SemanticDOM, CSSProperties>--
value指定当前选中的条目,支持 v-model:valuestring--
variant形态变体outlined | borderless | filled | underlinedoutlined-
virtual设置 false 时关闭虚拟滚动booleantrue-

Events

事件说明类型版本
blur失去焦点时的回调(e: FocusEvent) => void-
change选中 option,或 input 的 value 变化时,调用此函数(value: string) => void-
clear清除内容时的回调() => void-
focus获得焦点时的回调(e: FocusEvent) => void-
inputKeydown按键按下时回调(e: KeyboardEvent) => void-
openChange展开下拉菜单的回调(open: boolean) => void-
popupScroll下拉列表滚动时的回调(e: UIEvent) => void-
search搜索补全项的时候调用(value: string) => void-
select被选中时调用,参数为选中项的 value 值(value: string, option: Option) => void-

FormCreate 是一个开源项目,基于 MIT 许可证发布,欢迎个人和企业用户免费使用