---
title: AutoComplete 自动填充
description: 用于根据用户输入内容提示更多联想词场景
isComponent: true
usage: { title: "", description: "" }
spline: form
---

### 基础用法

- 通过属性 `options` 可设置下拉联想词列表。
- 通过属性 `value` 可指定输入框当前的联想词。支持语法 `v-model`

{{ base }}

### 可过滤

- 设置 `filterable` 后的默认过滤规则为：不区分大小写，文本任意位置。
- 如果 `filterable` 的默认规则不符合需求，可以使用 `filter` 自定义过滤规则。

{{ filter }}

### 可自定义联想词

- 使用 `option` 自定义联想词

{{ option }}

### 可自定义触发元素

通过属性 `triggerElement` 可自定义触发显示联想词下拉框的元素，默认为 `Input` 组件，可以使用 `trigger` 自定义为 `Textarea` 组件或其他组件。

{{ trigger-element }}

### 不同尺寸

通过属性 `size` 可设置组件尺寸，支持 `small`、`medium`、`large`

{{ size }}

### 不同状态的自动填充

- 通过属性 `status` 可设置输入框状态，支持 `default`、`success`、`warning`、`error` <br />
- 通过属性 `disabled` 可禁用输入框，通过属性 `readonly` 可设置输入框可读状态

{{ status }}
