AutoComplete 自动填充

输入框自动完成功能。

AutoComplete

Props

Prop NameTypeRequiredDefaultDescription
options
Item[]
[]
待筛选选项
valuestring
值,controlled
defaultValuestring''
默认值
onChange
(v: string) => void
选中回调
disabledboolean
是否禁用
loadingboolean
options 加载中状态
prefixReactNode
前缀
blockboolean
展示变更为块占位
handleSearch
false | ((v: Item) => boolean)
自定义搜索,为 false 时不做搜索展示全部
popoverProps
{ [key: string]: any }
自定义 popover 的配置
onFocus
() => void
焦点回调
onBlur
() => void
失焦回调
statusInputProps['status']required
状态

说明

  • AutoComplete 能够尝试猜测⽤户输⼊的⽂字,并且动态的搜索出适配的结果并推荐给⽤户,辅助完成输⼊。⽬的是避免⽤户出错,起到提示作⽤,智能预测⽤户⼼理期望,从⽽确保他们的输⼊更有效率。
  • 默认的弹出层容器为 forwardPopupContainer={triggerNode => triggerNode.parentNode},默认会查找上层的建议容器

数据结构

Item

interface Item {
    // 项的值
    value: string;
    // 项的展示,为空时展示 value
    label?: ReactNode;
}

演示

普通使用

VIEW CODE ( LIVE )

disabled - 禁用

VIEW CODE ( LIVE )

options - 选项展示

VIEW CODE ( LIVE )

handleSearch - 自定义搜索

VIEW CODE ( LIVE )

controlled - 受控

VIEW CODE ( LIVE )

动态加载数据

VIEW CODE ( LIVE )

如何实现输入为空时隐藏选项

VIEW CODE ( LIVE )

输入建议

VIEW CODE ( LIVE )

popupContainer - 容器测试

VIEW CODE ( LIVE )

边界测试

VIEW CODE ( LIVE )
Copyright © 2021-2024 UCloud 优刻得科技股份有限公司