/** * TODO: 4.0 * * - Remove `dataSource` * - `size` not work with customizeInput * - CustomizeInput not feedback `ENTER` key since accessibility enhancement */ import classNames from 'classnames'; import type { BaseSelectRef } from 'rc-select'; import toArray from 'rc-util/lib/Children/toArray'; import omit from 'rc-util/lib/omit'; import * as React from 'react'; import type { ConfigConsumerProps } from '../config-provider'; import { ConfigContext } from '../config-provider'; import type { BaseOptionType, DefaultOptionType, InternalSelectProps, RefSelectProps, } from '../select'; import Select from '../select'; import genPurePanel from '../_util/PurePanel'; import { isValidElement } from '../_util/reactNode'; import type { InputStatus } from '../_util/statusUtils'; import warning from '../_util/warning'; const { Option } = Select; export interface DataSourceItemObject { value: string; text: string; } export type DataSourceItemType = DataSourceItemObject | React.ReactNode; export interface AutoCompleteProps< ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType, > extends Omit< InternalSelectProps, 'inputIcon' | 'loading' | 'mode' | 'optionLabelProp' | 'labelInValue' > { dataSource?: DataSourceItemType[]; status?: InputStatus; popupClassName?: string; /** @deprecated Please use `popupClassName` instead */ dropdownClassName?: string; } function isSelectOptionOrSelectOptGroup(child: any): Boolean { return child && child.type && (child.type.isSelectOption || child.type.isSelectOptGroup); } const AutoComplete: React.ForwardRefRenderFunction = ( props, ref, ) => { const { prefixCls: customizePrefixCls, className, popupClassName, dropdownClassName, children, dataSource, } = props; const childNodes: React.ReactElement[] = toArray(children); // ============================= Input ============================= let customizeInput: React.ReactElement | undefined; if ( childNodes.length === 1 && isValidElement(childNodes[0]) && !isSelectOptionOrSelectOptGroup(childNodes[0]) ) { [customizeInput] = childNodes; } const getInputElement = customizeInput ? (): React.ReactElement => customizeInput! : undefined; // ============================ Options ============================ let optionChildren: React.ReactNode; // [Legacy] convert `children` or `dataSource` into option children if (childNodes.length && isSelectOptionOrSelectOptGroup(childNodes[0])) { optionChildren = children; } else { optionChildren = dataSource ? dataSource.map((item) => { if (isValidElement(item)) { return item; } switch (typeof item) { case 'string': return ( ); case 'object': { const { value: optionValue } = item as DataSourceItemObject; return ( ); } default: warning( false, 'AutoComplete', '`dataSource` is only supports type `string[] | Object[]`.', ); return undefined; } }) : []; } if (process.env.NODE_ENV !== 'production') { warning( !('dataSource' in props), 'AutoComplete', '`dataSource` is deprecated, please use `options` instead.', ); warning( !customizeInput || !('size' in props), 'AutoComplete', 'You need to control style self instead of setting `size` when using customize input.', ); warning( !dropdownClassName, 'AutoComplete', '`dropdownClassName` is deprecated, please use `popupClassName` instead.', ); } const { getPrefixCls } = React.useContext(ConfigContext); const prefixCls = getPrefixCls('select', customizePrefixCls); return ( ); }; const RefAutoComplete = React.forwardRef( AutoComplete, ) as unknown as (< ValueType = any, OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType, >( props: React.PropsWithChildren> & { ref?: React.Ref; }, ) => React.ReactElement) & { Option: typeof Option; _InternalPanelDoNotUseOrYouWillBeFired: typeof PurePanel; }; // We don't care debug panel /* istanbul ignore next */ const PurePanel = genPurePanel(RefAutoComplete); RefAutoComplete.Option = Option; RefAutoComplete._InternalPanelDoNotUseOrYouWillBeFired = PurePanel; if (process.env.NODE_ENV !== 'production') { AutoComplete.displayName = 'AutoComplete'; } export default RefAutoComplete;