ant-design-vue/components/auto-complete/index.zh-CN.md

category	subtitle	type	cols	title	cover
Components	自动完成	数据录入	2	AutoComplete	https://gw.alipayobjects.com/zos/alicdn/qtJm4yt45/AutoComplete.svg

输入框自动完成功能。

何时使用

• 需要一个输入框而不是选择器。
• 需要输入建议/辅助提示。

和 Select 的区别是：

• AutoComplete 是一个带提示的文本输入框，用户可以自由输入，关键词是辅助输入。
• Select 是在限定的可选项中进行选择，关键词是选择。

API

<a-auto-complete v-model:value="value" :options="options" />

参数	说明	类型	默认值	版本
allowClear	支持清除, 单选模式有效	boolean	false
autofocus	自动获取焦点	boolean	false
backfill	使用键盘选择选项的时候把选中项回填到输入框中	boolean	false
#default (自定义输入框)	自定义输入框	HTMLInputElement / HTMLTextAreaElement	<Input />
options	自动完成的数据源	DataSourceItemType[]
option	通过 option 插槽，自定义节点	v-slot:option="{value, label, [disabled, key, title]}"	-	3.0
dropdownMenuStyle	dropdown 菜单自定义样式	object		1.5.0
defaultActiveFirstOption	是否默认高亮第一个选项。	boolean	true
disabled	是否禁用	boolean	false
dropdownMatchSelectWidth	下拉菜单和选择器同宽。默认将设置 min-width，当值小于选择框宽度时会被忽略。false 时会关闭虚拟滚动	boolean | number	true
filterOption	是否根据输入项进行筛选。当其为一个函数时，会接收 inputValue option 两个参数，当 option 符合筛选条件时，应返回 true，反之则返回 false。	boolean or function(inputValue, option)	true
optionLabelProp	回填到选择框的 Option 的属性值，默认是 Option 的子元素。比如在子元素需要高亮效果时，此值可以设为 value。	string	children
placeholder	输入框提示	string | slot	-
v-model:value	指定当前选中的条目	string|string[]|{ key: string, label: string|vNodes }|Array<{ key: string, label: string|vNodes }>	无
defaultOpen	是否默认展开下拉菜单	boolean	-
open	是否展开下拉菜单	boolean	-

事件

事件名称	说明	回调参数	版本
change	选中 option，或 input 的 value 变化时，调用此函数	function(value)
blur	失去焦点时的回调	function()
focus	获得焦点时的回调	function()
search	搜索补全项的时候调用	function(value)
select	被选中时调用，参数为选中项的 value 值	function(value, option)
dropdownVisibleChange	展开下拉菜单的回调	function(open)

方法

名称	描述	版本
blur()	移除焦点
focus()	获取焦点