This commit is contained in:
2026-05-25 17:08:18 +08:00
parent df501f6151
commit f1259b71b5
9178 changed files with 1626125 additions and 0 deletions
+8
View File
@@ -0,0 +1,8 @@
export type GutterUnit = number | string;
export type RowContextGutter = readonly [GutterUnit, GutterUnit];
export interface RowContextState {
gutter?: RowContextGutter;
wrap?: boolean;
}
declare const RowContext: import("react").Context<RowContextState>;
export default RowContext;
+3
View File
@@ -0,0 +1,3 @@
import { createContext } from 'react';
const RowContext = /*#__PURE__*/createContext({});
export default RowContext;
+24
View File
@@ -0,0 +1,24 @@
import * as React from 'react';
import type { Breakpoint } from '../_util/responsiveObserver';
import type { LiteralUnion } from '../_util/type';
type ColSpanType = number | string;
type FlexType = number | LiteralUnion<'none' | 'auto'>;
export interface ColSize {
flex?: FlexType;
span?: ColSpanType;
order?: ColSpanType;
offset?: ColSpanType;
push?: ColSpanType;
pull?: ColSpanType;
}
export interface ColProps extends React.HTMLAttributes<HTMLDivElement>, Partial<Record<Breakpoint, ColSpanType | ColSize>> {
flex?: FlexType;
span?: ColSpanType;
order?: ColSpanType;
offset?: ColSpanType;
push?: ColSpanType;
pull?: ColSpanType;
prefixCls?: string;
}
declare const Col: React.ForwardRefExoticComponent<ColProps & React.RefAttributes<HTMLDivElement>>;
export default Col;
+113
View File
@@ -0,0 +1,113 @@
"use client";
import * as React from 'react';
import { clsx } from 'clsx';
import { isNonNullable, isNumber, isPlainObject } from '../_util/is';
import { responsiveArrayReversed } from '../_util/responsiveObserver';
import { ConfigContext } from '../config-provider';
import { genCssVar } from '../theme/util/genStyleUtils';
import RowContext from './RowContext';
import { useColStyle } from './style';
function parseFlex(flex) {
if (flex === 'auto') {
return '1 1 auto';
}
if (isNumber(flex)) {
return `${flex} ${flex} auto`;
}
if (/^\d+(\.\d+)?(px|em|rem|%)$/.test(flex)) {
return `0 0 ${flex}`;
}
return flex;
}
const Col = /*#__PURE__*/React.forwardRef((props, ref) => {
const {
getPrefixCls,
direction
} = React.useContext(ConfigContext);
const {
gutter,
wrap
} = React.useContext(RowContext);
const {
prefixCls: customizePrefixCls,
span,
order,
offset,
push,
pull,
className,
children,
flex,
style,
...others
} = props;
const prefixCls = getPrefixCls('col', customizePrefixCls);
const rootPrefixCls = getPrefixCls();
const [hashId, cssVarCls] = useColStyle(prefixCls);
const [varName] = genCssVar(rootPrefixCls, 'col');
// ===================== Size ======================
const sizeStyle = {};
let sizeClassObj = {};
responsiveArrayReversed.forEach(size => {
let sizeProps = {};
const propSize = props[size];
if (isNumber(propSize)) {
sizeProps.span = propSize;
} else if (isPlainObject(propSize)) {
sizeProps = propSize || {};
}
delete others[size];
sizeClassObj = {
...sizeClassObj,
[`${prefixCls}-${size}-${sizeProps.span}`]: isNonNullable(sizeProps.span),
[`${prefixCls}-${size}-order-${sizeProps.order}`]: sizeProps.order || sizeProps.order === 0,
[`${prefixCls}-${size}-offset-${sizeProps.offset}`]: sizeProps.offset || sizeProps.offset === 0,
[`${prefixCls}-${size}-push-${sizeProps.push}`]: sizeProps.push || sizeProps.push === 0,
[`${prefixCls}-${size}-pull-${sizeProps.pull}`]: sizeProps.pull || sizeProps.pull === 0,
[`${prefixCls}-rtl`]: direction === 'rtl'
};
// Responsive flex layout
if (sizeProps.flex) {
sizeClassObj[`${prefixCls}-${size}-flex`] = true;
sizeStyle[varName(`${size}-flex`)] = parseFlex(sizeProps.flex);
}
});
// ==================== Normal =====================
const classes = clsx(prefixCls, {
[`${prefixCls}-${span}`]: span !== undefined,
[`${prefixCls}-order-${order}`]: order,
[`${prefixCls}-offset-${offset}`]: offset,
[`${prefixCls}-push-${push}`]: push,
[`${prefixCls}-pull-${pull}`]: pull
}, className, sizeClassObj, hashId, cssVarCls);
const mergedStyle = {};
// Horizontal gutter use padding
if (gutter?.[0]) {
const horizontalGutter = isNumber(gutter[0]) ? `${gutter[0] / 2}px` : `calc(${gutter[0]} / 2)`;
mergedStyle.paddingInline = horizontalGutter;
}
if (flex) {
mergedStyle.flex = parseFlex(flex);
// Hack for Firefox to avoid size issue
// https://github.com/ant-design/ant-design/pull/20023#issuecomment-564389553
if (wrap === false && !mergedStyle.minWidth) {
mergedStyle.minWidth = 0;
}
}
// ==================== Render =====================
return /*#__PURE__*/React.createElement("div", {
...others,
style: {
...mergedStyle,
...style,
...sizeStyle
},
className: classes,
ref: ref
}, children);
});
if (process.env.NODE_ENV !== 'production') {
Col.displayName = 'Col';
}
export default Col;
+4
View File
@@ -0,0 +1,4 @@
import type { ScreenMap } from '../../_util/responsiveObserver';
declare function useBreakpoint(refreshOnChange: boolean, defaultScreens: null): ScreenMap | null;
declare function useBreakpoint(refreshOnChange?: boolean, defaultScreens?: ScreenMap): ScreenMap;
export default useBreakpoint;
+22
View File
@@ -0,0 +1,22 @@
"use client";
import { useRef } from 'react';
import useLayoutEffect from "@rc-component/util/es/hooks/useLayoutEffect";
import { useForceUpdate } from '../../_util/hooks';
import useResponsiveObserver from '../../_util/responsiveObserver';
function useBreakpoint(refreshOnChange = true, defaultScreens = {}) {
const screensRef = useRef(defaultScreens);
const [, forceUpdate] = useForceUpdate();
const responsiveObserver = useResponsiveObserver();
useLayoutEffect(() => {
const token = responsiveObserver.subscribe(supportScreens => {
screensRef.current = supportScreens;
if (refreshOnChange) {
forceUpdate();
}
});
return () => responsiveObserver.unsubscribe(token);
}, []);
return screensRef.current;
}
export default useBreakpoint;
+4
View File
@@ -0,0 +1,4 @@
import type { ScreenMap } from '../../_util/responsiveObserver';
import type { RowProps } from '../row';
export type Gap = number | string | undefined;
export default function useGutter(gutter: RowProps['gutter'], screens: ScreenMap | null): [Gap, Gap];
+30
View File
@@ -0,0 +1,30 @@
import { isPlainObject } from '../../_util/is';
import { responsiveArray } from '../../_util/responsiveObserver';
export default function useGutter(gutter, screens) {
const results = [undefined, undefined];
const normalizedGutter = Array.isArray(gutter) ? gutter : [gutter, undefined];
// By default use as `xs`
const mergedScreens = screens || {
xs: true,
sm: true,
md: true,
lg: true,
xl: true,
xxl: true,
xxxl: true
};
normalizedGutter.forEach((g, index) => {
if (isPlainObject(g)) {
for (let i = 0; i < responsiveArray.length; i++) {
const breakpoint = responsiveArray[i];
if (mergedScreens[breakpoint] && g[breakpoint] !== undefined) {
results[index] = g[breakpoint];
break;
}
}
} else {
results[index] = g;
}
});
return results;
}
+10
View File
@@ -0,0 +1,10 @@
import Col from './col';
import Row from './row';
declare function useBreakpoint(): Partial<Record<"xs" | "sm" | "md" | "lg" | "xl" | "xxl" | "xxxl", boolean>>;
export type { ColProps, ColSize } from './col';
export type { RowProps } from './row';
export { Col, Row };
declare const _default: {
useBreakpoint: typeof useBreakpoint;
};
export default _default;
+13
View File
@@ -0,0 +1,13 @@
"use client";
import Col from './col';
import useInternalBreakpoint from './hooks/useBreakpoint';
import Row from './row';
// Do not export params
function useBreakpoint() {
return useInternalBreakpoint();
}
export { Col, Row };
export default {
useBreakpoint
};
+19
View File
@@ -0,0 +1,19 @@
import * as React from 'react';
import type { Breakpoint } from '../_util/responsiveObserver';
declare const _RowAligns: readonly ["top", "middle", "bottom", "stretch"];
declare const _RowJustify: readonly ["start", "end", "center", "space-around", "space-between", "space-evenly"];
type ResponsiveLike<T> = {
[key in Breakpoint]?: T;
};
export type Gutter = number | string | undefined | Partial<Record<Breakpoint, number>>;
type ResponsiveAligns = ResponsiveLike<(typeof _RowAligns)[number]>;
type ResponsiveJustify = ResponsiveLike<(typeof _RowJustify)[number]>;
export interface RowProps extends React.HTMLAttributes<HTMLDivElement> {
gutter?: Gutter | [Gutter, Gutter];
align?: (typeof _RowAligns)[number] | ResponsiveAligns;
justify?: (typeof _RowJustify)[number] | ResponsiveJustify;
prefixCls?: string;
wrap?: boolean;
}
declare const Row: React.ForwardRefExoticComponent<RowProps & React.RefAttributes<HTMLDivElement>>;
export default Row;
+98
View File
@@ -0,0 +1,98 @@
"use client";
import * as React from 'react';
import { clsx } from 'clsx';
import { isNumber, isPlainObject, isString } from '../_util/is';
import { responsiveArray } from '../_util/responsiveObserver';
import { ConfigContext } from '../config-provider';
import useBreakpoint from './hooks/useBreakpoint';
import useGutter from './hooks/useGutter';
import RowContext from './RowContext';
import { useRowStyle } from './style';
const _RowAligns = ['top', 'middle', 'bottom', 'stretch'];
const _RowJustify = ['start', 'end', 'center', 'space-around', 'space-between', 'space-evenly'];
const useMergedPropByScreen = (oriProp, screen) => {
const [prop, setProp] = React.useState(() => isString(oriProp) ? oriProp : '');
const calcMergedAlignOrJustify = () => {
if (isString(oriProp)) {
setProp(oriProp);
}
if (!isPlainObject(oriProp)) {
return;
}
for (let i = 0; i < responsiveArray.length; i++) {
const breakpoint = responsiveArray[i];
// if do not match, do nothing
if (!screen || !screen[breakpoint]) {
continue;
}
const curVal = oriProp[breakpoint];
if (curVal !== undefined) {
setProp(curVal);
return;
}
}
};
React.useEffect(() => {
calcMergedAlignOrJustify();
}, [JSON.stringify(oriProp), screen]);
return prop;
};
const Row = /*#__PURE__*/React.forwardRef((props, ref) => {
const {
prefixCls: customizePrefixCls,
justify,
align,
className,
style,
children,
gutter = 0,
wrap,
...others
} = props;
const {
getPrefixCls,
direction
} = React.useContext(ConfigContext);
const screens = useBreakpoint(true, null);
const mergedAlign = useMergedPropByScreen(align, screens);
const mergedJustify = useMergedPropByScreen(justify, screens);
const prefixCls = getPrefixCls('row', customizePrefixCls);
const [hashId, cssVarCls] = useRowStyle(prefixCls);
const gutters = useGutter(gutter, screens);
const classes = clsx(prefixCls, {
[`${prefixCls}-no-wrap`]: wrap === false,
[`${prefixCls}-${mergedJustify}`]: mergedJustify,
[`${prefixCls}-${mergedAlign}`]: mergedAlign,
[`${prefixCls}-rtl`]: direction === 'rtl'
}, className, hashId, cssVarCls);
// Add gutter related style
const rowStyle = {};
if (gutters?.[0]) {
const horizontalGutter = isNumber(gutters[0]) ? `${gutters[0] / -2}px` : `calc(${gutters[0]} / -2)`;
rowStyle.marginInline = horizontalGutter;
}
// "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;
rowStyle.rowGap = gutterV;
const rowContext = React.useMemo(() => ({
gutter: [gutterH, gutterV],
wrap
}), [gutterH, gutterV, wrap]);
return /*#__PURE__*/React.createElement(RowContext.Provider, {
value: rowContext
}, /*#__PURE__*/React.createElement("div", {
...others,
className: classes,
style: {
...rowStyle,
...style
},
ref: ref
}, children));
});
if (process.env.NODE_ENV !== 'production') {
Row.displayName = 'Row';
}
export default Row;
+16
View File
@@ -0,0 +1,16 @@
import type { AliasToken, GetDefaultToken } from '../../theme/internal';
export interface ComponentToken {
}
export declare const prepareRowComponentToken: GetDefaultToken<'Grid'>;
export declare const prepareColComponentToken: GetDefaultToken<'Grid'>;
export declare const useRowStyle: (prefixCls: string, rootCls?: string) => readonly [string, string];
export declare const getMediaSize: (token: AliasToken) => {
readonly xs: number;
readonly sm: number;
readonly md: number;
readonly lg: number;
readonly xl: number;
readonly xxl: number;
readonly xxxl: number;
};
export declare const useColStyle: (prefixCls: string, rootCls?: string) => readonly [string, string];
+169
View File
@@ -0,0 +1,169 @@
import { unit } from '@ant-design/cssinjs';
import { genStyleHooks, mergeToken } from '../../theme/internal';
import { genCssVar } from '../../theme/util/genStyleUtils';
// ============================== Row-Shared ==============================
const genGridRowStyle = token => {
const {
componentCls
} = token;
return {
// Grid system
[componentCls]: {
display: 'flex',
flexFlow: 'row wrap',
minWidth: 0,
'&::before, &::after': {
display: 'flex'
},
'&-no-wrap': {
flexWrap: 'nowrap'
},
// The origin of the X-axis
'&-start': {
justifyContent: 'flex-start'
},
// The center of the X-axis
'&-center': {
justifyContent: 'center'
},
// The opposite of the X-axis
'&-end': {
justifyContent: 'flex-end'
},
'&-space-between': {
justifyContent: 'space-between'
},
'&-space-around': {
justifyContent: 'space-around'
},
'&-space-evenly': {
justifyContent: 'space-evenly'
},
// Align at the top
'&-top': {
alignItems: 'flex-start'
},
// Align at the center
'&-middle': {
alignItems: 'center'
},
'&-bottom': {
alignItems: 'flex-end'
}
}
};
};
// ============================== Col-Shared ==============================
const genGridColStyle = token => {
const {
componentCls
} = token;
return {
// Grid system
[componentCls]: {
position: 'relative',
maxWidth: '100%',
// Prevent columns from collapsing when empty
minHeight: 1
}
};
};
const genLoopGridColumnsStyle = (token, sizeCls) => {
const {
componentCls,
gridColumns,
antCls
} = token;
const [gridVarName, gridVarRef] = genCssVar(antCls, 'grid');
const [, colVarRef] = genCssVar(antCls, 'col');
const gridColumnsStyle = {};
for (let i = gridColumns; i >= 0; i--) {
if (i === 0) {
gridColumnsStyle[`${componentCls}${sizeCls}-${i}`] = {
display: 'none'
};
gridColumnsStyle[`${componentCls}-push-${i}`] = {
insetInlineStart: 'auto'
};
gridColumnsStyle[`${componentCls}-pull-${i}`] = {
insetInlineEnd: 'auto'
};
gridColumnsStyle[`${componentCls}${sizeCls}-push-${i}`] = {
insetInlineStart: 'auto'
};
gridColumnsStyle[`${componentCls}${sizeCls}-pull-${i}`] = {
insetInlineEnd: 'auto'
};
gridColumnsStyle[`${componentCls}${sizeCls}-offset-${i}`] = {
marginInlineStart: 0
};
gridColumnsStyle[`${componentCls}${sizeCls}-order-${i}`] = {
order: 0
};
} else {
gridColumnsStyle[`${componentCls}${sizeCls}-${i}`] = [
// https://github.com/ant-design/ant-design/issues/44456
// Form set `display: flex` on Col which will override `display: block`.
// Let's get it from css variable to support override.
{
[gridVarName('display')]: 'block',
// Fallback to display if variable not support
display: 'block'
}, {
display: gridVarRef('display'),
flex: `0 0 ${i / gridColumns * 100}%`,
maxWidth: `${i / gridColumns * 100}%`
}];
gridColumnsStyle[`${componentCls}${sizeCls}-push-${i}`] = {
insetInlineStart: `${i / gridColumns * 100}%`
};
gridColumnsStyle[`${componentCls}${sizeCls}-pull-${i}`] = {
insetInlineEnd: `${i / gridColumns * 100}%`
};
gridColumnsStyle[`${componentCls}${sizeCls}-offset-${i}`] = {
marginInlineStart: `${i / gridColumns * 100}%`
};
gridColumnsStyle[`${componentCls}${sizeCls}-order-${i}`] = {
order: i
};
}
}
// Flex CSS Var
gridColumnsStyle[`${componentCls}${sizeCls}-flex`] = {
flex: colVarRef(`${sizeCls.replace(/-/, '')}-flex`)
};
return gridColumnsStyle;
};
const genGridStyle = (token, sizeCls) => genLoopGridColumnsStyle(token, sizeCls);
const genGridMediaStyle = (token, screenSize, sizeCls) => ({
[`@media (min-width: ${unit(screenSize)})`]: {
...genGridStyle(token, sizeCls)
}
});
export const prepareRowComponentToken = () => ({});
export const prepareColComponentToken = () => ({});
// ============================== Export ==============================
export const useRowStyle = genStyleHooks('Grid', genGridRowStyle, prepareRowComponentToken);
export const getMediaSize = token => {
const mediaSizesMap = {
xs: token.screenXSMin,
sm: token.screenSMMin,
md: token.screenMDMin,
lg: token.screenLGMin,
xl: token.screenXLMin,
xxl: token.screenXXLMin,
xxxl: token.screenXXXLMin
};
return mediaSizesMap;
};
export const useColStyle = genStyleHooks('Grid', token => {
const gridToken = mergeToken(token, {
gridColumns: 24 // Row is divided into 24 parts in Grid
});
const gridMediaSizesMap = getMediaSize(gridToken);
delete gridMediaSizesMap.xs;
return [genGridColStyle(gridToken), genGridStyle(gridToken, ''), genGridStyle(gridToken, '-xs'), Object.keys(gridMediaSizesMap).map(key => genGridMediaStyle(gridToken, gridMediaSizesMap[key], `-${key}`)).reduce((pre, cur) => ({
...pre,
...cur
}), {})];
}, prepareColComponentToken);