import * as React from 'react'; import CheckCircleFilled from '@ant-design/icons/CheckCircleFilled'; import CheckOutlined from '@ant-design/icons/CheckOutlined'; import CloseCircleFilled from '@ant-design/icons/CloseCircleFilled'; import CloseOutlined from '@ant-design/icons/CloseOutlined'; import classNames from 'classnames'; import omit from 'rc-util/lib/omit'; import { devUseWarning } from '../_util/warning'; import type { ConfigConsumerProps } from '../config-provider'; import { ConfigContext } from '../config-provider'; import Circle from './Circle'; import Line from './Line'; import Steps from './Steps'; import useStyle from './style'; import { getSize, getSuccessPercent, validProgress } from './utils'; export const ProgressTypes = ['line', 'circle', 'dashboard'] as const; export type ProgressType = (typeof ProgressTypes)[number]; const ProgressStatuses = ['normal', 'exception', 'active', 'success'] as const; export type ProgressSize = 'default' | 'small'; export type StringGradients = Record; type FromToGradients = { from: string; to: string }; export type ProgressGradient = { direction?: string } & (StringGradients | FromToGradients); export interface SuccessProps { percent?: number; /** @deprecated Use `percent` instead */ progress?: number; strokeColor?: string; } export type ProgressAriaProps = Pick; export interface ProgressProps extends ProgressAriaProps { prefixCls?: string; className?: string; rootClassName?: string; type?: ProgressType; percent?: number; format?: (percent?: number, successPercent?: number) => React.ReactNode; status?: (typeof ProgressStatuses)[number]; showInfo?: boolean; strokeWidth?: number; strokeLinecap?: 'butt' | 'square' | 'round'; strokeColor?: string | string[] | ProgressGradient; trailColor?: string; /** @deprecated Use `size` instead */ width?: number; success?: SuccessProps; style?: React.CSSProperties; gapDegree?: number; gapPosition?: 'top' | 'bottom' | 'left' | 'right'; size?: number | [number | string, number] | ProgressSize; steps?: number | { count: number; gap: number }; /** @deprecated Use `success` instead */ successPercent?: number; children?: React.ReactNode; } const Progress = React.forwardRef((props, ref) => { const { prefixCls: customizePrefixCls, className, rootClassName, steps, strokeColor, percent = 0, size = 'default', showInfo = true, type = 'line', status, format, style, ...restProps } = props; const percentNumber = React.useMemo(() => { const successPercent = getSuccessPercent(props); return parseInt( successPercent !== undefined ? (successPercent ?? 0)?.toString() : (percent ?? 0)?.toString(), 10, ); }, [percent, props.success, props.successPercent]); const progressStatus = React.useMemo<(typeof ProgressStatuses)[number]>(() => { if (!ProgressStatuses.includes(status!) && percentNumber >= 100) { return 'success'; } return status || 'normal'; }, [status, percentNumber]); const { getPrefixCls, direction, progress: progressStyle, } = React.useContext(ConfigContext); const prefixCls = getPrefixCls('progress', customizePrefixCls); const [wrapCSSVar, hashId, cssVarCls] = useStyle(prefixCls); const progressInfo = React.useMemo(() => { if (!showInfo) { return null; } const successPercent = getSuccessPercent(props); let text: React.ReactNode; const textFormatter = format || ((number) => `${number}%`); const isLineType = type === 'line'; if (format || (progressStatus !== 'exception' && progressStatus !== 'success')) { text = textFormatter(validProgress(percent), validProgress(successPercent)); } else if (progressStatus === 'exception') { text = isLineType ? : ; } else if (progressStatus === 'success') { text = isLineType ? : ; } return ( {text} ); }, [showInfo, percent, percentNumber, progressStatus, type, prefixCls, format]); if (process.env.NODE_ENV !== 'production') { const warning = devUseWarning('Progress'); warning.deprecated(!('successPercent' in props), 'successPercent', 'success.percent'); warning.deprecated(!('width' in props), 'width', 'size'); if ((type === 'circle' || type === 'dashboard') && Array.isArray(size)) { warning( false, 'usage', 'Type "circle" and "dashboard" do not accept array as `size`, please use number or preset size instead.', ); } if (props.success && 'progress' in props.success) { warning.deprecated(false, 'success.progress', 'success.percent'); } } const strokeColorNotArray = Array.isArray(strokeColor) ? strokeColor[0] : strokeColor; const strokeColorNotGradient = typeof strokeColor === 'string' || Array.isArray(strokeColor) ? strokeColor : undefined; let progress: React.ReactNode; // Render progress shape if (type === 'line') { progress = steps ? ( {progressInfo} ) : ( {progressInfo} ); } else if (type === 'circle' || type === 'dashboard') { progress = ( {progressInfo} ); } const classString = classNames( prefixCls, `${prefixCls}-status-${progressStatus}`, { [`${prefixCls}-${(type === 'dashboard' && 'circle') || type}`]: type !== 'line', [`${prefixCls}-inline-circle`]: type === 'circle' && getSize(size, 'circle')[0] <= 20, [`${prefixCls}-line`]: !steps && type === 'line', [`${prefixCls}-steps`]: steps, [`${prefixCls}-show-info`]: showInfo, [`${prefixCls}-${size}`]: typeof size === 'string', [`${prefixCls}-rtl`]: direction === 'rtl', }, progressStyle?.className, className, rootClassName, hashId, cssVarCls, ); return wrapCSSVar(
{progress}
, ); }); if (process.env.NODE_ENV !== 'production') { Progress.displayName = 'Progress'; } export default Progress;