mirror of
https://gitee.com/ant-design/ant-design.git
synced 2024-12-06 05:58:46 +08:00
9680481546
* chore: add layer mark * docs: enable @layer for test * docs: add doc of third part lib * docs: update order * Update docs/react/compatible-style.zh-CN.md Co-authored-by: lijianan <574980606@qq.com> Signed-off-by: 二货爱吃白萝卜 <smith3816@gmail.com> * Update docs/react/compatible-style.en-US.md Co-authored-by: lijianan <574980606@qq.com> Signed-off-by: 二货爱吃白萝卜 <smith3816@gmail.com> * docs: ssr or reset case --------- Signed-off-by: 二货爱吃白萝卜 <smith3816@gmail.com> Co-authored-by: lijianan <574980606@qq.com>
422 lines
12 KiB
TypeScript
422 lines
12 KiB
TypeScript
/* eslint-disable no-redeclare */
|
|
import type { ComponentType, FC, ReactElement } from 'react';
|
|
import React, { useContext } from 'react';
|
|
import type { CSSInterpolation } from '@ant-design/cssinjs';
|
|
import { token2CSSVar, useCSSVarRegister, useStyleRegister } from '@ant-design/cssinjs';
|
|
import { warning } from 'rc-util';
|
|
|
|
import { ConfigContext } from '../../config-provider/context';
|
|
import { genCommonStyle, genLinkStyle } from '../../style';
|
|
import type {
|
|
AliasToken,
|
|
ComponentTokenMap,
|
|
GlobalToken,
|
|
OverrideToken,
|
|
UseComponentStyleResult,
|
|
} from '../interface';
|
|
import useToken, { ignore, unitless } from '../useToken';
|
|
import genCalc from './calc';
|
|
import type AbstractCalculator from './calc/calculator';
|
|
import genMaxMin from './maxmin';
|
|
import statisticToken, { merge as mergeToken } from './statistic';
|
|
import useResetIconStyle from './useResetIconStyle';
|
|
|
|
export type OverrideTokenWithoutDerivative = ComponentTokenMap;
|
|
export type OverrideComponent = keyof OverrideTokenWithoutDerivative;
|
|
export type GlobalTokenWithComponent<C extends OverrideComponent> = GlobalToken &
|
|
ComponentTokenMap[C];
|
|
|
|
type ComponentToken<C extends OverrideComponent> = Exclude<OverrideToken[C], undefined>;
|
|
type ComponentTokenKey<C extends OverrideComponent> = keyof ComponentToken<C>;
|
|
|
|
export interface StyleInfo {
|
|
hashId: string;
|
|
prefixCls: string;
|
|
rootPrefixCls: string;
|
|
iconPrefixCls: string;
|
|
}
|
|
|
|
export type CSSUtil = {
|
|
calc: (number: any) => AbstractCalculator;
|
|
max: (...values: (number | string)[]) => number | string;
|
|
min: (...values: (number | string)[]) => number | string;
|
|
};
|
|
|
|
export type TokenWithCommonCls<T> = T & {
|
|
/** Wrap component class with `.` prefix */
|
|
componentCls: string;
|
|
/** Origin prefix which do not have `.` prefix */
|
|
prefixCls: string;
|
|
/** Wrap icon class with `.` prefix */
|
|
iconCls: string;
|
|
/** Wrap ant prefixCls class with `.` prefix */
|
|
antCls: string;
|
|
} & CSSUtil;
|
|
|
|
export type FullToken<C extends OverrideComponent> = TokenWithCommonCls<
|
|
GlobalTokenWithComponent<C>
|
|
>;
|
|
|
|
export type GenStyleFn<C extends OverrideComponent> = (
|
|
token: FullToken<C>,
|
|
info: StyleInfo,
|
|
) => CSSInterpolation;
|
|
|
|
export type GetDefaultToken<C extends OverrideComponent> =
|
|
| null
|
|
| OverrideTokenWithoutDerivative[C]
|
|
| ((
|
|
token: AliasToken & Partial<OverrideTokenWithoutDerivative[C]>,
|
|
) => OverrideTokenWithoutDerivative[C]);
|
|
|
|
const getDefaultComponentToken = <C extends OverrideComponent>(
|
|
component: C,
|
|
token: GlobalToken,
|
|
getDefaultToken: GetDefaultToken<C>,
|
|
) => {
|
|
if (typeof getDefaultToken === 'function') {
|
|
return getDefaultToken(mergeToken<any>(token, token[component] ?? {}));
|
|
}
|
|
return getDefaultToken ?? {};
|
|
};
|
|
|
|
const getComponentToken = <C extends OverrideComponent>(
|
|
component: C,
|
|
token: GlobalToken,
|
|
defaultToken: OverrideTokenWithoutDerivative[C],
|
|
options?: {
|
|
deprecatedTokens?: [ComponentTokenKey<C>, ComponentTokenKey<C>][];
|
|
},
|
|
) => {
|
|
const customToken = { ...(token[component] as ComponentToken<C>) };
|
|
if (options?.deprecatedTokens) {
|
|
const { deprecatedTokens } = options;
|
|
deprecatedTokens.forEach(([oldTokenKey, newTokenKey]) => {
|
|
if (process.env.NODE_ENV !== 'production') {
|
|
warning(
|
|
!customToken?.[oldTokenKey],
|
|
`Component Token \`${String(
|
|
oldTokenKey,
|
|
)}\` of ${component} is deprecated. Please use \`${String(newTokenKey)}\` instead.`,
|
|
);
|
|
}
|
|
|
|
// Should wrap with `if` clause, or there will be `undefined` in object.
|
|
if (customToken?.[oldTokenKey] || customToken?.[newTokenKey]) {
|
|
customToken[newTokenKey] ??= customToken?.[oldTokenKey];
|
|
}
|
|
});
|
|
}
|
|
const mergedToken: any = { ...defaultToken, ...customToken };
|
|
|
|
// Remove same value as global token to minimize size
|
|
Object.keys(mergedToken).forEach((key) => {
|
|
if (mergedToken[key] === token[key as keyof GlobalToken]) {
|
|
delete mergedToken[key];
|
|
}
|
|
});
|
|
|
|
return mergedToken;
|
|
};
|
|
|
|
const getCompVarPrefix = (component: string, prefix?: string) =>
|
|
`${[
|
|
prefix,
|
|
component.replace(/([A-Z]+)([A-Z][a-z]+)/g, '$1-$2').replace(/([a-z])([A-Z])/g, '$1-$2'),
|
|
]
|
|
.filter(Boolean)
|
|
.join('-')}`;
|
|
|
|
export default function genComponentStyleHook<C extends OverrideComponent>(
|
|
componentName: C | [C, string],
|
|
styleFn: GenStyleFn<C>,
|
|
getDefaultToken?: GetDefaultToken<C>,
|
|
options: {
|
|
resetStyle?: boolean;
|
|
// Deprecated token key map [["oldTokenKey", "newTokenKey"], ["oldTokenKey", "newTokenKey"]]
|
|
deprecatedTokens?: [ComponentTokenKey<C>, ComponentTokenKey<C>][];
|
|
/**
|
|
* Only use component style in client side. Ignore in SSR.
|
|
*/
|
|
clientOnly?: boolean;
|
|
/**
|
|
* Set order of component style. Default is -999.
|
|
*/
|
|
order?: number;
|
|
injectStyle?: boolean;
|
|
} = {},
|
|
) {
|
|
const cells = (Array.isArray(componentName) ? componentName : [componentName, componentName]) as [
|
|
C,
|
|
string,
|
|
];
|
|
|
|
const [component] = cells;
|
|
const concatComponent = cells.join('-');
|
|
|
|
return (prefixCls: string, rootCls: string = prefixCls): UseComponentStyleResult => {
|
|
const [theme, realToken, hashId, token, cssVar] = useToken();
|
|
const { getPrefixCls, iconPrefixCls, csp } = useContext(ConfigContext);
|
|
const rootPrefixCls = getPrefixCls();
|
|
|
|
const type = cssVar ? 'css' : 'js';
|
|
const calc = genCalc(type);
|
|
const { max, min } = genMaxMin(type);
|
|
|
|
// Shared config
|
|
const sharedConfig: Omit<Parameters<typeof useStyleRegister>[0], 'path'> = {
|
|
theme,
|
|
token,
|
|
hashId,
|
|
nonce: () => csp?.nonce!,
|
|
clientOnly: options.clientOnly,
|
|
layer: {
|
|
name: 'antd',
|
|
},
|
|
|
|
// antd is always at top of styles
|
|
order: options.order || -999,
|
|
};
|
|
|
|
// Generate style for all a tags in antd component.
|
|
useStyleRegister(
|
|
{ ...sharedConfig, clientOnly: false, path: ['Shared', rootPrefixCls] },
|
|
() => [
|
|
{
|
|
// Link
|
|
'&': genLinkStyle(token),
|
|
},
|
|
],
|
|
);
|
|
|
|
// Generate style for icons
|
|
useResetIconStyle(iconPrefixCls, csp);
|
|
|
|
const wrapSSR = useStyleRegister(
|
|
{ ...sharedConfig, path: [concatComponent, prefixCls, iconPrefixCls] },
|
|
() => {
|
|
if (options.injectStyle === false) {
|
|
return [];
|
|
}
|
|
|
|
const { token: proxyToken, flush } = statisticToken(token);
|
|
|
|
const defaultComponentToken = getDefaultComponentToken(
|
|
component,
|
|
realToken,
|
|
getDefaultToken,
|
|
);
|
|
|
|
const componentCls = `.${prefixCls}`;
|
|
const componentToken = getComponentToken(component, realToken, defaultComponentToken, {
|
|
deprecatedTokens: options.deprecatedTokens,
|
|
});
|
|
|
|
if (cssVar) {
|
|
Object.keys(defaultComponentToken).forEach((key) => {
|
|
defaultComponentToken[key] = `var(${token2CSSVar(
|
|
key,
|
|
getCompVarPrefix(component, cssVar.prefix),
|
|
)})`;
|
|
});
|
|
}
|
|
const mergedToken = mergeToken<
|
|
TokenWithCommonCls<GlobalTokenWithComponent<OverrideComponent>>
|
|
>(
|
|
proxyToken,
|
|
{
|
|
componentCls,
|
|
prefixCls,
|
|
iconCls: `.${iconPrefixCls}`,
|
|
antCls: `.${rootPrefixCls}`,
|
|
calc,
|
|
// @ts-ignore
|
|
max,
|
|
// @ts-ignore
|
|
min,
|
|
},
|
|
cssVar ? defaultComponentToken : componentToken,
|
|
);
|
|
|
|
const styleInterpolation = styleFn(mergedToken as unknown as FullToken<C>, {
|
|
hashId,
|
|
prefixCls,
|
|
rootPrefixCls,
|
|
iconPrefixCls,
|
|
});
|
|
flush(component, componentToken);
|
|
return [
|
|
options.resetStyle === false ? null : genCommonStyle(mergedToken, prefixCls, rootCls),
|
|
styleInterpolation,
|
|
];
|
|
},
|
|
);
|
|
|
|
return [wrapSSR as any, hashId];
|
|
};
|
|
}
|
|
|
|
export interface SubStyleComponentProps {
|
|
prefixCls: string;
|
|
rootCls?: string;
|
|
}
|
|
|
|
// Get from second argument
|
|
type RestParameters<T extends any[]> = T extends [any, ...infer Rest] ? Rest : never;
|
|
|
|
export const genSubStyleComponent: <C extends OverrideComponent>(
|
|
componentName: [C, string],
|
|
...args: RestParameters<Parameters<typeof genComponentStyleHook<C>>>
|
|
) => ComponentType<SubStyleComponentProps> = (componentName, styleFn, getDefaultToken, options) => {
|
|
const useStyle = genComponentStyleHook(componentName, styleFn, getDefaultToken, {
|
|
resetStyle: false,
|
|
|
|
// Sub Style should default after root one
|
|
order: -998,
|
|
...options,
|
|
});
|
|
|
|
const StyledComponent: ComponentType<SubStyleComponentProps> = ({
|
|
prefixCls,
|
|
rootCls = prefixCls,
|
|
}: SubStyleComponentProps) => {
|
|
useStyle(prefixCls, rootCls);
|
|
return null;
|
|
};
|
|
|
|
if (process.env.NODE_ENV !== 'production') {
|
|
StyledComponent.displayName = `SubStyle_${
|
|
Array.isArray(componentName) ? componentName.join('.') : componentName
|
|
}`;
|
|
}
|
|
|
|
return StyledComponent;
|
|
};
|
|
|
|
export type CSSVarRegisterProps = {
|
|
rootCls: string;
|
|
component: string;
|
|
cssVar: {
|
|
prefix?: string;
|
|
key?: string;
|
|
};
|
|
};
|
|
|
|
const genCSSVarRegister = <C extends OverrideComponent>(
|
|
component: C,
|
|
getDefaultToken?: GetDefaultToken<C>,
|
|
options?: {
|
|
unitless?: {
|
|
[key in ComponentTokenKey<C>]: boolean;
|
|
};
|
|
deprecatedTokens?: [ComponentTokenKey<C>, ComponentTokenKey<C>][];
|
|
injectStyle?: boolean;
|
|
},
|
|
) => {
|
|
function prefixToken(key: string) {
|
|
return `${component}${key.slice(0, 1).toUpperCase()}${key.slice(1)}`;
|
|
}
|
|
|
|
const { unitless: originUnitless = {}, injectStyle = true } = options ?? {};
|
|
const compUnitless: any = {
|
|
[prefixToken('zIndexPopup')]: true,
|
|
};
|
|
Object.keys(originUnitless).forEach((key) => {
|
|
compUnitless[prefixToken(key)] = originUnitless[key as keyof ComponentTokenKey<C>];
|
|
});
|
|
|
|
const CSSVarRegister: FC<CSSVarRegisterProps> = ({ rootCls, cssVar }) => {
|
|
const [, realToken] = useToken();
|
|
useCSSVarRegister(
|
|
{
|
|
path: [component],
|
|
prefix: cssVar.prefix,
|
|
key: cssVar?.key!,
|
|
unitless: {
|
|
...unitless,
|
|
...compUnitless,
|
|
},
|
|
ignore,
|
|
token: realToken,
|
|
scope: rootCls,
|
|
},
|
|
() => {
|
|
const defaultToken = getDefaultComponentToken(component, realToken, getDefaultToken);
|
|
const componentToken = getComponentToken(component, realToken, defaultToken, {
|
|
deprecatedTokens: options?.deprecatedTokens,
|
|
});
|
|
Object.keys(defaultToken).forEach((key) => {
|
|
componentToken[prefixToken(key)] = componentToken[key];
|
|
delete componentToken[key];
|
|
});
|
|
return componentToken;
|
|
},
|
|
);
|
|
return null;
|
|
};
|
|
|
|
const useCSSVar = (rootCls: string) => {
|
|
const [, , , , cssVar] = useToken();
|
|
|
|
return [
|
|
(node: ReactElement): ReactElement =>
|
|
injectStyle && cssVar ? (
|
|
<>
|
|
<CSSVarRegister rootCls={rootCls} cssVar={cssVar} component={component} />
|
|
{node}
|
|
</>
|
|
) : (
|
|
node
|
|
),
|
|
cssVar?.key,
|
|
] as const;
|
|
};
|
|
|
|
return useCSSVar;
|
|
};
|
|
|
|
export const genStyleHooks = <C extends OverrideComponent>(
|
|
component: C | [C, string],
|
|
styleFn: GenStyleFn<C>,
|
|
getDefaultToken?: GetDefaultToken<C>,
|
|
options?: {
|
|
resetStyle?: boolean;
|
|
deprecatedTokens?: [ComponentTokenKey<C>, ComponentTokenKey<C>][];
|
|
/**
|
|
* Component tokens that do not need unit.
|
|
*/
|
|
unitless?: {
|
|
[key in ComponentTokenKey<C>]: boolean;
|
|
};
|
|
/**
|
|
* Only use component style in client side. Ignore in SSR.
|
|
*/
|
|
clientOnly?: boolean;
|
|
/**
|
|
* Set order of component style.
|
|
* @default -999
|
|
*/
|
|
order?: number;
|
|
/**
|
|
* Whether generate styles
|
|
* @default true
|
|
*/
|
|
injectStyle?: boolean;
|
|
},
|
|
) => {
|
|
const useStyle = genComponentStyleHook(component, styleFn, getDefaultToken, options);
|
|
|
|
const useCSSVar = genCSSVarRegister(
|
|
Array.isArray(component) ? component[0] : component,
|
|
getDefaultToken,
|
|
options,
|
|
);
|
|
|
|
return (prefixCls: string, rootCls: string = prefixCls) => {
|
|
const [, hashId] = useStyle(prefixCls, rootCls);
|
|
const [wrapCSSVar, cssVarCls] = useCSSVar(rootCls);
|
|
|
|
return [wrapCSSVar, hashId, cssVarCls] as const;
|
|
};
|
|
};
|