mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-15 09:21:22 +08:00
139 lines
4.1 KiB
TypeScript
139 lines
4.1 KiB
TypeScript
import * as React from 'react';
|
|
import classNames from 'classnames';
|
|
import { ConfigContext } from '../config-provider';
|
|
import RowContext from './RowContext';
|
|
import { tuple } from '../_util/type';
|
|
import ResponsiveObserve, {
|
|
Breakpoint,
|
|
ScreenMap,
|
|
responsiveArray,
|
|
} from '../_util/responsiveObserve';
|
|
import useFlexGapSupport from '../_util/hooks/useFlexGapSupport';
|
|
|
|
const RowAligns = tuple('top', 'middle', 'bottom', 'stretch');
|
|
const RowJustify = tuple('start', 'end', 'center', 'space-around', 'space-between');
|
|
|
|
export type Gutter = number | Partial<Record<Breakpoint, number>>;
|
|
export interface RowProps extends React.HTMLAttributes<HTMLDivElement> {
|
|
gutter?: Gutter | [Gutter, Gutter];
|
|
align?: typeof RowAligns[number];
|
|
justify?: typeof RowJustify[number];
|
|
prefixCls?: string;
|
|
wrap?: boolean;
|
|
}
|
|
|
|
const Row = React.forwardRef<HTMLDivElement, RowProps>((props, ref) => {
|
|
const {
|
|
prefixCls: customizePrefixCls,
|
|
justify,
|
|
align,
|
|
className,
|
|
style,
|
|
children,
|
|
gutter = 0,
|
|
wrap,
|
|
...others
|
|
} = props;
|
|
|
|
const { getPrefixCls, direction } = React.useContext(ConfigContext);
|
|
|
|
const [screens, setScreens] = React.useState<ScreenMap>({
|
|
xs: true,
|
|
sm: true,
|
|
md: true,
|
|
lg: true,
|
|
xl: true,
|
|
xxl: true,
|
|
});
|
|
|
|
const supportFlexGap = useFlexGapSupport();
|
|
|
|
const gutterRef = React.useRef<Gutter | [Gutter, Gutter]>(gutter);
|
|
|
|
// ================================== Effect ==================================
|
|
React.useEffect(() => {
|
|
const token = ResponsiveObserve.subscribe(screen => {
|
|
const currentGutter = gutterRef.current || 0;
|
|
if (
|
|
(!Array.isArray(currentGutter) && typeof currentGutter === 'object') ||
|
|
(Array.isArray(currentGutter) &&
|
|
(typeof currentGutter[0] === 'object' || typeof currentGutter[1] === 'object'))
|
|
) {
|
|
setScreens(screen);
|
|
}
|
|
});
|
|
return () => ResponsiveObserve.unsubscribe(token);
|
|
}, []);
|
|
|
|
// ================================== Render ==================================
|
|
const getGutter = (): [number, number] => {
|
|
const results: [number, number] = [0, 0];
|
|
const normalizedGutter = Array.isArray(gutter) ? gutter : [gutter, 0];
|
|
normalizedGutter.forEach((g, index) => {
|
|
if (typeof g === 'object') {
|
|
for (let i = 0; i < responsiveArray.length; i++) {
|
|
const breakpoint: Breakpoint = responsiveArray[i];
|
|
if (screens[breakpoint] && g[breakpoint] !== undefined) {
|
|
results[index] = g[breakpoint] as number;
|
|
break;
|
|
}
|
|
}
|
|
} else {
|
|
results[index] = g || 0;
|
|
}
|
|
});
|
|
return results;
|
|
};
|
|
|
|
const prefixCls = getPrefixCls('row', customizePrefixCls);
|
|
const gutters = getGutter();
|
|
const classes = classNames(
|
|
prefixCls,
|
|
{
|
|
[`${prefixCls}-no-wrap`]: wrap === false,
|
|
[`${prefixCls}-${justify}`]: justify,
|
|
[`${prefixCls}-${align}`]: align,
|
|
[`${prefixCls}-rtl`]: direction === 'rtl',
|
|
},
|
|
className,
|
|
);
|
|
|
|
// Add gutter related style
|
|
const rowStyle: React.CSSProperties = {};
|
|
const horizontalGutter = gutters[0] > 0 ? gutters[0] / -2 : undefined;
|
|
const verticalGutter = gutters[1] > 0 ? gutters[1] / -2 : undefined;
|
|
|
|
if (horizontalGutter) {
|
|
rowStyle.marginLeft = horizontalGutter;
|
|
rowStyle.marginRight = horizontalGutter;
|
|
}
|
|
|
|
if (supportFlexGap) {
|
|
// Set gap direct if flex gap support
|
|
[, rowStyle.rowGap] = gutters;
|
|
} else if (verticalGutter) {
|
|
rowStyle.marginTop = verticalGutter;
|
|
rowStyle.marginBottom = verticalGutter;
|
|
}
|
|
|
|
// "gutters" is a new array in each rendering phase, it'll make 'React.useMemo' effectless.
|
|
// So we deconstruct "gutters" variable here.
|
|
const [gutterH, gutterV] = gutters;
|
|
const rowContext = React.useMemo(
|
|
() => ({ gutter: [gutterH, gutterV] as [number, number], wrap, supportFlexGap }),
|
|
[gutterH, gutterV, wrap, supportFlexGap],
|
|
);
|
|
|
|
return (
|
|
<RowContext.Provider value={rowContext}>
|
|
<div {...others} className={classes} style={{ ...rowStyle, ...style }} ref={ref}>
|
|
{children}
|
|
</div>
|
|
</RowContext.Provider>
|
|
);
|
|
});
|
|
|
|
Row.displayName = 'Row';
|
|
|
|
export default Row;
|