import * as React from 'react'; import classNames from 'classnames'; import omit from 'rc-util/lib/omit'; import { debounce } from 'throttle-debounce'; import { cloneElement } from '../_util/reactNode'; import { devUseWarning } from '../_util/warning'; import type { ConfigConsumerProps } from '../config-provider'; import { ConfigContext } from '../config-provider'; import useStyle from './style/index'; const SpinSizes = ['small', 'default', 'large'] as const; export type SpinSize = (typeof SpinSizes)[number]; export type SpinIndicator = React.ReactElement; export interface SpinProps { /** Customize prefix class name */ prefixCls?: string; /** Additional class name of Spin */ className?: string; /** Additional root class name of Spin */ rootClassName?: string; /** Whether Spin is spinning */ spinning?: boolean; /** Style of Spin */ style?: React.CSSProperties; /** Size of Spin, options: `small`, `default` and `large` */ size?: SpinSize; /** Customize description content when Spin has children */ tip?: React.ReactNode; /** Specifies a delay in milliseconds for loading state (prevent flush) */ delay?: number; /** The className of wrapper when Spin has children */ wrapperClassName?: string; /** React node of the spinning indicator */ indicator?: SpinIndicator; /** Children of Spin */ children?: React.ReactNode; /** Display a backdrop with the `Spin` component */ fullscreen?: boolean; } export type SpinType = React.FC & { setDefaultIndicator: (indicator: React.ReactNode) => void; }; // Render indicator let defaultIndicator: React.ReactNode = null; function renderIndicator(prefixCls: string, props: SpinProps): React.ReactNode { const { indicator } = props; const dotClassName = `${prefixCls}-dot`; // should not be render default indicator when indicator value is null if (indicator === null) { return null; } if (React.isValidElement(indicator)) { return cloneElement(indicator, { className: classNames(indicator.props.className, dotClassName), }); } if (React.isValidElement(defaultIndicator)) { return cloneElement(defaultIndicator, { className: classNames(defaultIndicator.props.className, dotClassName), }); } return ( ); } function shouldDelay(spinning?: boolean, delay?: number): boolean { return !!spinning && !!delay && !isNaN(Number(delay)); } const Spin: SpinType = (props) => { const { prefixCls: customizePrefixCls, spinning: customSpinning = true, delay = 0, className, rootClassName, size = 'default', tip, wrapperClassName, style, children, fullscreen = false, ...restProps } = props; const { getPrefixCls } = React.useContext(ConfigContext); const prefixCls = getPrefixCls('spin', customizePrefixCls); const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls); const [spinning, setSpinning] = React.useState( () => customSpinning && !shouldDelay(customSpinning, delay), ); React.useEffect(() => { if (customSpinning) { const showSpinning = debounce(delay, () => { setSpinning(true); }); showSpinning(); return () => { showSpinning?.cancel?.(); }; } setSpinning(false); }, [delay, customSpinning]); const isNestedPattern = React.useMemo( () => typeof children !== 'undefined' && !fullscreen, [children, fullscreen], ); if (process.env.NODE_ENV !== 'production') { const warning = devUseWarning('Spin'); warning( !tip || isNestedPattern || fullscreen, 'usage', '`tip` only work in nest or fullscreen pattern.', ); } const { direction, spin } = React.useContext(ConfigContext); const spinClassName = classNames( prefixCls, spin?.className, { [`${prefixCls}-sm`]: size === 'small', [`${prefixCls}-lg`]: size === 'large', [`${prefixCls}-spinning`]: spinning, [`${prefixCls}-show-text`]: !!tip, [`${prefixCls}-fullscreen`]: fullscreen, [`${prefixCls}-fullscreen-show`]: fullscreen && spinning, [`${prefixCls}-rtl`]: direction === 'rtl', }, className, rootClassName, hashId, cssVarCls, ); const containerClassName = classNames(`${prefixCls}-container`, { [`${prefixCls}-blur`]: spinning, }); // fix https://fb.me/react-unknown-prop const divProps = omit(restProps, ['indicator']); const mergedStyle: React.CSSProperties = { ...spin?.style, ...style }; const spinElement: React.ReactNode = (
{renderIndicator(prefixCls, props)} {tip && (isNestedPattern || fullscreen) ? (
{tip}
) : null}
); if (isNestedPattern) { return wrapCSSVar(
{spinning &&
{spinElement}
}
{children}
, ); } return wrapCSSVar(spinElement); }; Spin.setDefaultIndicator = (indicator: React.ReactNode) => { defaultIndicator = indicator; }; if (process.env.NODE_ENV !== 'production') { Spin.displayName = 'Spin'; } export default Spin;