AutoComplete 自动完成
规则
基础示例
Props 配置示例
静态联想词
自定义过滤
禁用
尺寸对比(小 / 中 / 大)
Events 事件示例
监听输入与选中
完整配置项:TDesign_AutoComplete
value:string
Props
| 参数 | 说明 | 类型 | 默认值 | 版本 |
|---|---|---|---|---|
| autofocus | 自动获取焦点 | boolean | - | - |
| borderless | 无边框模式 | boolean | false | - |
| clearable | 是否允许清空 | boolean | - | - |
| default | 触发下拉的元素(同 triggerElement) | string | TNode | - | - |
| disabled | 是否禁用 | boolean | - | - |
| empty | 联想词列表为空时显示内容 | string | TNode | - | - |
| filter | 自定义过滤规则 | (filterWords: string, option: T) => boolean | Promise<boolean> | - | - |
| filterable | 是否根据输入过滤联想词 | boolean | true | - |
| highlightKeyword | 是否高亮匹配部分 | boolean | true | - |
| inputProps | 透传 Input 属性 | InputProps | - | - |
| options | 下拉联想词列表 | Array<T> | - | - |
| panelBottomContent | 面板底部内容 | string | TNode | - | - |
| panelTopContent | 面板顶部内容 | string | TNode | - | - |
| placeholder | 占位提示 | string | - | - |
| popupProps | 透传 Popup 属性 | PopupProps | - | - |
| readonly | 是否只读 | boolean | - | - |
| size | 尺寸 | small | medium | large | medium | - |
| status | 输入框状态 | default | success | warning | error | default | - |
| textareaProps | 透传 Textarea 属性 | TextareaProps | - | - |
| tips | 下方提示文本 | string | TNode | - | - |
| triggerElement | 触发下拉的元素 | string | TNode | - | - |
| value | 输入框值 | string | - | - |
| defaultValue | 非受控值 | string | - | - |
Events
| 事件 | 说明 | 类型 | 版本 |
|---|---|---|---|
| blur | 失去焦点 | (context: { e: FocusEvent; value: string }) => void | - |
| change | 值变化 | (value: string, context?: { e?: InputEvent | MouseEvent | CompositionEvent | KeyboardEvent }) => void | - |
| clear | 清空 | (context: { e: MouseEvent }) => void | - |
| compositionend | 中文输入结束 | (context: { e: CompositionEvent; value: string }) => void | - |
| compositionstart | 中文输入开始 | (context: { e: CompositionEvent; value: string }) => void | - |
| enter | 回车 | (context: { e: KeyboardEvent; value: string }) => void | - |
| focus | 获得焦点 | (context: { e: FocusEvent; value: string }) => void | - |
| select | 选中联想词 | (value: string, context: { e: MouseEvent | KeyboardEvent }) => void | - |


