mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-09 15:41:33 +08:00
851d551906
* chore: warning for dropdownMatchSelectWidth * test: update snapshot * test: update test case * fix: align context * chore: warning deprecated * chore: fix lint
280 lines
8.9 KiB
TypeScript
Executable File
280 lines
8.9 KiB
TypeScript
Executable File
// TODO: 4.0 - codemod should help to change `filterOption` to support node props.
|
|
import classNames from 'classnames';
|
|
import type { BaseSelectRef, SelectProps as RcSelectProps } from 'rc-select';
|
|
import RcSelect, { OptGroup, Option } from 'rc-select';
|
|
import type { OptionProps } from 'rc-select/lib/Option';
|
|
import type { BaseOptionType, DefaultOptionType } from 'rc-select/lib/Select';
|
|
import omit from 'rc-util/lib/omit';
|
|
import * as React from 'react';
|
|
import genPurePanel from '../_util/PurePanel';
|
|
import type { SelectCommonPlacement } from '../_util/motion';
|
|
import { getTransitionDirection, getTransitionName } from '../_util/motion';
|
|
import type { InputStatus } from '../_util/statusUtils';
|
|
import { getMergedStatus, getStatusClassNames } from '../_util/statusUtils';
|
|
import warning from '../_util/warning';
|
|
import { ConfigContext } from '../config-provider';
|
|
import DisabledContext from '../config-provider/DisabledContext';
|
|
import type { SizeType } from '../config-provider/SizeContext';
|
|
import SizeContext from '../config-provider/SizeContext';
|
|
import DefaultRenderEmpty from '../config-provider/defaultRenderEmpty';
|
|
import { FormItemInputContext } from '../form/context';
|
|
import { useCompactItemContext } from '../space/Compact';
|
|
import useStyle from './style';
|
|
import useBuiltinPlacements from './useBuiltinPlacements';
|
|
import useShowArrow from './useShowArrow';
|
|
import getIcons from './utils/iconUtil';
|
|
|
|
type RawValue = string | number;
|
|
|
|
export type { OptionProps, BaseSelectRef as RefSelectProps, BaseOptionType, DefaultOptionType };
|
|
|
|
export interface LabeledValue {
|
|
key?: string;
|
|
value: RawValue;
|
|
label: React.ReactNode;
|
|
}
|
|
|
|
export type SelectValue = RawValue | RawValue[] | LabeledValue | LabeledValue[] | undefined;
|
|
|
|
export interface InternalSelectProps<
|
|
ValueType = any,
|
|
OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,
|
|
> extends Omit<RcSelectProps<ValueType, OptionType>, 'mode'> {
|
|
suffixIcon?: React.ReactNode;
|
|
size?: SizeType;
|
|
disabled?: boolean;
|
|
mode?: 'multiple' | 'tags' | 'SECRET_COMBOBOX_MODE_DO_NOT_USE';
|
|
bordered?: boolean;
|
|
}
|
|
|
|
export interface SelectProps<
|
|
ValueType = any,
|
|
OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,
|
|
> extends Omit<
|
|
InternalSelectProps<ValueType, OptionType>,
|
|
'inputIcon' | 'mode' | 'getInputElement' | 'getRawInputElement' | 'backfill' | 'placement'
|
|
> {
|
|
placement?: SelectCommonPlacement;
|
|
mode?: 'multiple' | 'tags';
|
|
status?: InputStatus;
|
|
popupClassName?: string;
|
|
/** @deprecated Please use `popupClassName` instead */
|
|
dropdownClassName?: string;
|
|
rootClassName?: string;
|
|
/** @deprecated Please use `popupMatchSelectWidth` instead */
|
|
dropdownMatchSelectWidth?: boolean | number;
|
|
popupMatchSelectWidth?: boolean | number;
|
|
}
|
|
|
|
const SECRET_COMBOBOX_MODE_DO_NOT_USE = 'SECRET_COMBOBOX_MODE_DO_NOT_USE';
|
|
|
|
const InternalSelect = <OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType>(
|
|
{
|
|
prefixCls: customizePrefixCls,
|
|
bordered = true,
|
|
className,
|
|
rootClassName,
|
|
getPopupContainer,
|
|
popupClassName,
|
|
dropdownClassName,
|
|
listHeight = 256,
|
|
placement,
|
|
listItemHeight = 24,
|
|
size: customizeSize,
|
|
disabled: customDisabled,
|
|
notFoundContent,
|
|
status: customStatus,
|
|
showArrow,
|
|
builtinPlacements,
|
|
dropdownMatchSelectWidth,
|
|
popupMatchSelectWidth,
|
|
...props
|
|
}: SelectProps<OptionType>,
|
|
ref: React.Ref<BaseSelectRef>,
|
|
) => {
|
|
const {
|
|
getPopupContainer: getContextPopupContainer,
|
|
getPrefixCls,
|
|
renderEmpty,
|
|
direction,
|
|
virtual,
|
|
popupMatchSelectWidth: contextPopupMatchSelectWidth,
|
|
select,
|
|
} = React.useContext(ConfigContext);
|
|
const size = React.useContext(SizeContext);
|
|
|
|
const prefixCls = getPrefixCls('select', customizePrefixCls);
|
|
const rootPrefixCls = getPrefixCls();
|
|
const { compactSize, compactItemClassnames } = useCompactItemContext(prefixCls, direction);
|
|
|
|
const [wrapSSR, hashId] = useStyle(prefixCls);
|
|
|
|
const mode = React.useMemo(() => {
|
|
const { mode: m } = props as InternalSelectProps<OptionType>;
|
|
|
|
if ((m as any) === 'combobox') {
|
|
return undefined;
|
|
}
|
|
|
|
if (m === SECRET_COMBOBOX_MODE_DO_NOT_USE) {
|
|
return 'combobox';
|
|
}
|
|
|
|
return m;
|
|
}, [props.mode]);
|
|
|
|
const isMultiple = mode === 'multiple' || mode === 'tags';
|
|
const mergedShowArrow = useShowArrow(showArrow);
|
|
|
|
const mergedPopupMatchSelectWidth =
|
|
popupMatchSelectWidth ?? dropdownMatchSelectWidth ?? contextPopupMatchSelectWidth;
|
|
|
|
// ===================== Form Status =====================
|
|
const {
|
|
status: contextStatus,
|
|
hasFeedback,
|
|
isFormItemInput,
|
|
feedbackIcon,
|
|
} = React.useContext(FormItemInputContext);
|
|
const mergedStatus = getMergedStatus(contextStatus, customStatus);
|
|
|
|
// ===================== Empty =====================
|
|
let mergedNotFound: React.ReactNode;
|
|
if (notFoundContent !== undefined) {
|
|
mergedNotFound = notFoundContent;
|
|
} else if (mode === 'combobox') {
|
|
mergedNotFound = null;
|
|
} else {
|
|
mergedNotFound = renderEmpty?.('Select') || <DefaultRenderEmpty componentName="Select" />;
|
|
}
|
|
|
|
// ===================== Icons =====================
|
|
const { suffixIcon, itemIcon, removeIcon, clearIcon } = getIcons({
|
|
...props,
|
|
multiple: isMultiple,
|
|
hasFeedback,
|
|
feedbackIcon,
|
|
showArrow: mergedShowArrow,
|
|
prefixCls,
|
|
});
|
|
|
|
const selectProps = omit(props as typeof props & { itemIcon: any }, ['suffixIcon', 'itemIcon']);
|
|
|
|
const rcSelectRtlDropdownClassName = classNames(
|
|
popupClassName || dropdownClassName,
|
|
{
|
|
[`${prefixCls}-dropdown-${direction}`]: direction === 'rtl',
|
|
},
|
|
rootClassName,
|
|
hashId,
|
|
);
|
|
|
|
const mergedSize = compactSize || customizeSize || size;
|
|
|
|
// ===================== Disabled =====================
|
|
const disabled = React.useContext(DisabledContext);
|
|
const mergedDisabled = customDisabled ?? disabled;
|
|
|
|
const mergedClassName = classNames(
|
|
{
|
|
[`${prefixCls}-lg`]: mergedSize === 'large',
|
|
[`${prefixCls}-sm`]: mergedSize === 'small',
|
|
[`${prefixCls}-rtl`]: direction === 'rtl',
|
|
[`${prefixCls}-borderless`]: !bordered,
|
|
[`${prefixCls}-in-form-item`]: isFormItemInput,
|
|
},
|
|
getStatusClassNames(prefixCls, mergedStatus, hasFeedback),
|
|
compactItemClassnames,
|
|
className,
|
|
rootClassName,
|
|
hashId,
|
|
);
|
|
|
|
// ===================== Placement =====================
|
|
const memoPlacement = React.useMemo<SelectCommonPlacement>(() => {
|
|
if (placement !== undefined) {
|
|
return placement;
|
|
}
|
|
return direction === 'rtl' ? 'bottomRight' : 'bottomLeft';
|
|
}, [placement, direction]);
|
|
|
|
const mergedBuiltinPlacements = useBuiltinPlacements(builtinPlacements);
|
|
|
|
// ====================== Warning ======================
|
|
if (process.env.NODE_ENV !== 'production') {
|
|
warning(
|
|
!dropdownClassName,
|
|
'Select',
|
|
'`dropdownClassName` is deprecated. Please use `popupClassName` instead.',
|
|
);
|
|
|
|
warning(
|
|
dropdownMatchSelectWidth === undefined,
|
|
'Select',
|
|
'`dropdownMatchSelectWidth` is deprecated. Please use `popupMatchSelectWidth` instead.',
|
|
);
|
|
}
|
|
|
|
// ====================== Render =======================
|
|
return wrapSSR(
|
|
<RcSelect<any, any>
|
|
ref={ref}
|
|
virtual={virtual}
|
|
showSearch={select?.showSearch}
|
|
{...selectProps}
|
|
dropdownMatchSelectWidth={mergedPopupMatchSelectWidth}
|
|
builtinPlacements={mergedBuiltinPlacements}
|
|
transitionName={getTransitionName(
|
|
rootPrefixCls,
|
|
getTransitionDirection(placement),
|
|
props.transitionName,
|
|
)}
|
|
listHeight={listHeight}
|
|
listItemHeight={listItemHeight}
|
|
mode={mode}
|
|
prefixCls={prefixCls}
|
|
placement={memoPlacement}
|
|
direction={direction}
|
|
inputIcon={suffixIcon}
|
|
menuItemSelectedIcon={itemIcon}
|
|
removeIcon={removeIcon}
|
|
clearIcon={clearIcon}
|
|
notFoundContent={mergedNotFound}
|
|
className={mergedClassName}
|
|
getPopupContainer={getPopupContainer || getContextPopupContainer}
|
|
dropdownClassName={rcSelectRtlDropdownClassName}
|
|
showArrow={hasFeedback || mergedShowArrow}
|
|
disabled={mergedDisabled}
|
|
/>,
|
|
);
|
|
};
|
|
|
|
if (process.env.NODE_ENV !== 'production') {
|
|
InternalSelect.displayName = 'Select';
|
|
}
|
|
|
|
const Select = React.forwardRef(InternalSelect) as unknown as (<
|
|
ValueType = any,
|
|
OptionType extends BaseOptionType | DefaultOptionType = DefaultOptionType,
|
|
>(
|
|
props: React.PropsWithChildren<SelectProps<ValueType, OptionType>> & {
|
|
ref?: React.Ref<BaseSelectRef>;
|
|
},
|
|
) => React.ReactElement) & {
|
|
SECRET_COMBOBOX_MODE_DO_NOT_USE: string;
|
|
Option: typeof Option;
|
|
OptGroup: typeof OptGroup;
|
|
_InternalPanelDoNotUseOrYouWillBeFired: typeof PurePanel;
|
|
};
|
|
|
|
// We don't care debug panel
|
|
/* istanbul ignore next */
|
|
const PurePanel = genPurePanel(Select);
|
|
|
|
Select.SECRET_COMBOBOX_MODE_DO_NOT_USE = SECRET_COMBOBOX_MODE_DO_NOT_USE;
|
|
Select.Option = Option;
|
|
Select.OptGroup = OptGroup;
|
|
Select._InternalPanelDoNotUseOrYouWillBeFired = PurePanel;
|
|
|
|
export default Select;
|