import RightOutlined from '@ant-design/icons/RightOutlined'; import classNames from 'classnames'; import RcDropdown from 'rc-dropdown'; import useEvent from 'rc-util/lib/hooks/useEvent'; import useMergedState from 'rc-util/lib/hooks/useMergedState'; import omit from 'rc-util/lib/omit'; import * as React from 'react'; import genPurePanel from '../_util/PurePanel'; import type { AdjustOverflow } from '../_util/placements'; import getPlacements from '../_util/placements'; import { cloneElement } from '../_util/reactNode'; import warning from '../_util/warning'; import { ConfigContext } from '../config-provider'; import type { MenuProps } from '../menu'; import Menu from '../menu'; import { OverrideProvider } from '../menu/OverrideContext'; import { NoCompactStyle } from '../space/Compact'; import theme from '../theme'; import DropdownButton from './dropdown-button'; import useStyle from './style'; const Placements = [ 'topLeft', 'topCenter', 'topRight', 'bottomLeft', 'bottomCenter', 'bottomRight', 'top', 'bottom', ] as const; type Placement = typeof Placements[number]; type OverlayFunc = () => React.ReactElement; type Align = { points?: [string, string]; offset?: [number, number]; targetOffset?: [number, number]; overflow?: { adjustX?: boolean; adjustY?: boolean; }; useCssRight?: boolean; useCssBottom?: boolean; useCssTransform?: boolean; }; export type DropdownArrowOptions = { pointAtCenter?: boolean; }; export interface DropdownProps { menu?: MenuProps; autoFocus?: boolean; arrow?: boolean | DropdownArrowOptions; trigger?: ('click' | 'hover' | 'contextMenu')[]; dropdownRender?: (originNode: React.ReactNode) => React.ReactNode; onOpenChange?: (open: boolean) => void; open?: boolean; disabled?: boolean; destroyPopupOnHide?: boolean; align?: Align; getPopupContainer?: (triggerNode: HTMLElement) => HTMLElement; prefixCls?: string; className?: string; rootClassName?: string; transitionName?: string; placement?: Placement; overlayClassName?: string; overlayStyle?: React.CSSProperties; forceRender?: boolean; mouseEnterDelay?: number; mouseLeaveDelay?: number; openClassName?: string; children?: React.ReactNode; autoAdjustOverflow?: boolean | AdjustOverflow; // Deprecated /** @deprecated Please use `menu` instead */ overlay?: React.ReactElement | OverlayFunc; /** @deprecated Please use `open` instead */ visible?: boolean; /** @deprecated Please use `onOpenChange` instead */ onVisibleChange?: (open: boolean) => void; } type CompoundedComponent = React.FC & { Button: typeof DropdownButton; _InternalPanelDoNotUseOrYouWillBeFired: typeof WrapPurePanel; }; const Dropdown: CompoundedComponent = (props) => { const { menu, arrow, prefixCls: customizePrefixCls, children, trigger, disabled, dropdownRender, getPopupContainer, overlayClassName, rootClassName, open, onOpenChange, // Deprecated visible, onVisibleChange, mouseEnterDelay = 0.15, mouseLeaveDelay = 0.1, autoAdjustOverflow = true, placement = '', overlay, transitionName, } = props; const { getPopupContainer: getContextPopupContainer, getPrefixCls, direction, } = React.useContext(ConfigContext); // Warning for deprecated usage if (process.env.NODE_ENV !== 'production') { [ ['visible', 'open'], ['onVisibleChange', 'onOpenChange'], ].forEach(([deprecatedName, newName]) => { warning( !(deprecatedName in props), 'Dropdown', `\`${deprecatedName}\` is deprecated which will be removed in next major version, please use \`${newName}\` instead.`, ); }); warning( !('overlay' in props), 'Dropdown', '`overlay` is deprecated. Please use `menu` instead.', ); } const memoTransitionName = React.useMemo(() => { const rootPrefixCls = getPrefixCls(); if (transitionName !== undefined) { return transitionName; } if (placement.includes('top')) { return `${rootPrefixCls}-slide-down`; } return `${rootPrefixCls}-slide-up`; }, [getPrefixCls, placement, transitionName]); const memoPlacement = React.useMemo(() => { if (!placement) { return direction === 'rtl' ? 'bottomRight' : 'bottomLeft'; } if (placement.includes('Center')) { const newPlacement = placement.slice(0, placement.indexOf('Center')); warning( !placement.includes('Center'), 'Dropdown', `You are using '${placement}' placement in Dropdown, which is deprecated. Try to use '${newPlacement}' instead.`, ); return newPlacement; } return placement; }, [placement, direction]); if (process.env.NODE_ENV !== 'production') { [ ['visible', 'open'], ['onVisibleChange', 'onOpenChange'], ].forEach(([deprecatedName, newName]) => { warning( !(deprecatedName in props), 'Dropdown', `\`${deprecatedName}\` is deprecated, please use \`${newName}\` instead.`, ); }); } const prefixCls = getPrefixCls('dropdown', customizePrefixCls); const [wrapSSR, hashId] = useStyle(prefixCls); const { token } = theme.useToken(); const child = React.Children.only(children) as React.ReactElement; const dropdownTrigger = cloneElement(child, { className: classNames( `${prefixCls}-trigger`, { [`${prefixCls}-rtl`]: direction === 'rtl', }, child.props.className, ), disabled, }); const triggerActions = disabled ? [] : trigger; let alignPoint: boolean; if (triggerActions && triggerActions.includes('contextMenu')) { alignPoint = true; } // =========================== Open ============================ const [mergedOpen, setOpen] = useMergedState(false, { value: open ?? visible, }); const onInnerOpenChange = useEvent((nextOpen: boolean) => { onOpenChange?.(nextOpen); onVisibleChange?.(nextOpen); setOpen(nextOpen); }); // =========================== Overlay ============================ const overlayClassNameCustomized = classNames(overlayClassName, rootClassName, hashId, { [`${prefixCls}-rtl`]: direction === 'rtl', }); const builtinPlacements = getPlacements({ arrowPointAtCenter: typeof arrow === 'object' && arrow.pointAtCenter, autoAdjustOverflow, offset: token.marginXXS, arrowWidth: arrow ? token.sizePopupArrow : 0, borderRadius: token.borderRadius, }); const onMenuClick = React.useCallback(() => { setOpen(false); }, []); const renderOverlay = () => { // rc-dropdown already can process the function of overlay, but we have check logic here. // So we need render the element to check and pass back to rc-dropdown. let overlayNode: React.ReactNode; if (menu?.items) { overlayNode = ; } else if (typeof overlay === 'function') { overlayNode = overlay(); } else { overlayNode = overlay; } if (dropdownRender) { overlayNode = dropdownRender(overlayNode); } overlayNode = React.Children.only( typeof overlayNode === 'string' ? {overlayNode} : overlayNode, ); return ( } mode="vertical" selectable={false} onClick={onMenuClick} validator={({ mode }) => { // Warning if use other mode warning( !mode || mode === 'vertical', 'Dropdown', `mode="${mode}" is not supported for Dropdown's Menu.`, ); }} > {overlayNode} ); }; // ============================ Render ============================ return wrapSSR( {dropdownTrigger} , ); }; Dropdown.Button = DropdownButton; // We don't care debug panel const PurePanel = genPurePanel(Dropdown, 'dropdown', (prefixCls) => prefixCls); /* istanbul ignore next */ const WrapPurePanel = (props: DropdownProps) => ( ); Dropdown._InternalPanelDoNotUseOrYouWillBeFired = WrapPurePanel; if (process.env.NODE_ENV !== 'production') { Dropdown.displayName = 'Dropdown'; } export default Dropdown;