设计
设计指南
设计原则
样式指南
设计资源
Klein - Figma
Klein Font
官方图标库
开发
开发文档
React
Vue Web
敬请期待
开发资源
GitHub 代码仓库
生态产品
生态产品
Orion Fonts
敬请期待
Orio Market
敬请期待
Klein Pro
敬请期待
Klein Editor
敬请期待

自动完成 AutoComplete

输入框自动完成功能、一般在以下情况使用:

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

和 Select 的区别是:

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

基础示例

基本使用,通过 options 设置自动完成的数据源。

自定义选项

也可以直接传 AutoComplete.Option 作为 AutoComplete 的 children,而非使用 options。

自定义组件

自定义输入组件。

查询模式: 确定类目

查询模式: 确定类目 示例。

查询模式: 不确定类目

查询模式: 不确定类目 示例。

Auto.Complete

参数说明类型默认值
open是否展开下拉菜单boolean-
defaultOpen是否默认展开下拉菜单boolean-
value指定当前选中的条目string-
defaultValue指定默认选中的条目string-
defaultActiveFirstOption是否默认高亮第一个选项boolean-
dropdownClassName下拉菜单的 className 属性string-
dropdownMatchSelectWidth拉菜单和选择器同宽默认将设置 min-width,当值小于选择框宽度时会被忽略false 时会关闭虚拟滚动number-
getPopupContainer提示信息挂载点,默认挂载到 body 上((node?: HTMLElement) => HTMLElement)-
allowClear支持清除booleanfalse
autoFocus默认获取焦点booleanfalse
disabled禁用状态控制boolean-
filterOption是否根据输入项进行筛选当其为一个函数时,会接收 inputValue option 两个参数,当 option 符合筛选条件时,应返回 true,反之则返回 falseboolean-
options数据化配置选项内容,相比 jsx 定义会获得更好的渲染性能{ label?: string-
notFoundContent当下拉列表为空时显示的内容ReactNode-
placeholderplaceholderstring-
className自定义 classNamestring-
style自定义 styleCSSProperties-
onBlur失去焦点时回调((value?: any) => void)-
onFocus获得焦点时回调((value?: any) => void)-
onChange选中 option,或 input 的 value 变化时,调用此函数((value: any, option?: any) => void)-
onDropdownVisibleChange展开下拉菜单的回调((open: boolean) => void)-
onSearch文本框值变化时回调((value: string) => void)-
onSelect被选中时调用,参数为选中项的 value (或 key) 值((value?: any, option?: any) => void)-

贡献者