'use client'; import classNames from 'classnames'; import toArray from 'rc-util/lib/Children/toArray'; import * as React from 'react'; import useFlexGapSupport from '../_util/hooks/useFlexGapSupport'; import { ConfigContext } from '../config-provider'; import type { SizeType } from '../config-provider/SizeContext'; import Compact from './Compact'; import Item from './Item'; import { SpaceContextProvider } from './context'; import useStyle from './style'; export { SpaceContext } from './context'; export type SpaceSize = SizeType | number; export interface SpaceProps extends React.HTMLAttributes { prefixCls?: string; className?: string; rootClassName?: string; style?: React.CSSProperties; size?: SpaceSize | [SpaceSize, SpaceSize]; direction?: 'horizontal' | 'vertical'; // No `stretch` since many components do not support that. align?: 'start' | 'end' | 'center' | 'baseline'; split?: React.ReactNode; wrap?: boolean; classNames?: { item: string }; styles?: { item: React.CSSProperties }; } const spaceSize = { small: 8, middle: 16, large: 24, }; function getNumberSize(size: SpaceSize) { return typeof size === 'string' ? spaceSize[size] : size || 0; } const Space = React.forwardRef((props, ref) => { const { getPrefixCls, space, direction: directionConfig } = React.useContext(ConfigContext); const { size = space?.size || 'small', align, className, rootClassName, children, direction = 'horizontal', prefixCls: customizePrefixCls, split, style, wrap = false, classNames: customClassNames, styles, ...otherProps } = props; const supportFlexGap = useFlexGapSupport(); const [horizontalSize, verticalSize] = React.useMemo( () => ((Array.isArray(size) ? size : [size, size]) as [SpaceSize, SpaceSize]).map((item) => getNumberSize(item), ), [size], ); const childNodes = toArray(children, { keepEmpty: true }); const mergedAlign = align === undefined && direction === 'horizontal' ? 'center' : align; const prefixCls = getPrefixCls('space', customizePrefixCls); const [wrapSSR, hashId] = useStyle(prefixCls); const cn = classNames( prefixCls, space?.className, hashId, `${prefixCls}-${direction}`, { [`${prefixCls}-rtl`]: directionConfig === 'rtl', [`${prefixCls}-align-${mergedAlign}`]: mergedAlign, }, className, rootClassName, ); const itemClassName = classNames( `${prefixCls}-item`, customClassNames?.item ?? space?.classNames?.item, ); const marginDirection = directionConfig === 'rtl' ? 'marginLeft' : 'marginRight'; // Calculate latest one let latestIndex = 0; const nodes = childNodes.map((child, i) => { if (child !== null && child !== undefined) { latestIndex = i; } const key = (child && child.key) || `${itemClassName}-${i}`; return ( {child} ); }); const spaceContext = React.useMemo( () => ({ horizontalSize, verticalSize, latestIndex, supportFlexGap }), [horizontalSize, verticalSize, latestIndex, supportFlexGap], ); // =========================== Render =========================== if (childNodes.length === 0) { return null; } const gapStyle: React.CSSProperties = {}; if (wrap) { gapStyle.flexWrap = 'wrap'; // Patch for gap not support if (!supportFlexGap) { gapStyle.marginBottom = -verticalSize; } } if (supportFlexGap) { gapStyle.columnGap = horizontalSize; gapStyle.rowGap = verticalSize; } return wrapSSR(
{nodes}
, ); }); if (process.env.NODE_ENV !== 'production') { Space.displayName = 'Space'; } type CompoundedComponent = React.ForwardRefExoticComponent< SpaceProps & React.RefAttributes > & { Compact: typeof Compact; }; const CompoundedSpace = Space as CompoundedComponent; CompoundedSpace.Compact = Compact; export default CompoundedSpace;