ant-design/components/progress/__tests__/index.test.tsx
yykoypj 311a718956
feat: steps support for circular progress bar (#47940)
* feat: steps support for circular progress bar

* Update components/progress/index.zh-CN.md

Co-authored-by: afc163 <afc163@gmail.com>
Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.en-US.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.en-US.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.zh-CN.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.zh-CN.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.en-US.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/progress.tsx

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/__tests__/index.test.tsx

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/demo/circle-steps.tsx

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.en-US.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.en-US.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.zh-CN.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.zh-CN.md

Signed-off-by: lijianan <574980606@qq.com>

* Update circle-steps.tsx

* Update components/progress/progress.tsx

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.zh-CN.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.zh-CN.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.en-US.md

Signed-off-by: lijianan <574980606@qq.com>

* Update components/progress/index.en-US.md

Signed-off-by: lijianan <574980606@qq.com>

* Update package.json

* Update components/progress/demo/circle-steps.md

Co-authored-by: afc163 <afc163@gmail.com>
Signed-off-by: lijianan <574980606@qq.com>

---------

Signed-off-by: lijianan <574980606@qq.com>
Co-authored-by: lijianan <574980606@qq.com>
Co-authored-by: afc163 <afc163@gmail.com>
2024-03-24 18:30:53 +08:00

418 lines
16 KiB
TypeScript

import React, { useState } from 'react';
import { Tooltip } from 'antd';
import type { ProgressProps } from '..';
import Progress from '..';
import mountTest from '../../../tests/shared/mountTest';
import rtlTest from '../../../tests/shared/rtlTest';
import { fireEvent, render } from '../../../tests/utils';
import { handleGradient, sortGradient } from '../Line';
import ProgressSteps from '../Steps';
import { ProgressTypes } from '../progress';
describe('Progress', () => {
mountTest(Progress);
rtlTest(Progress);
it('successPercent should decide the progress status when it exists', () => {
const { container: wrapper, rerender } = render(
<Progress percent={100} success={{ percent: 50 }} />,
);
expect(wrapper.querySelectorAll('.ant-progress-status-success')).toHaveLength(0);
rerender(<Progress percent={50} success={{ percent: 100 }} />);
expect(wrapper.querySelectorAll('.ant-progress-status-success')).toHaveLength(1);
rerender(<Progress percent={100} success={{ percent: 0 }} />);
expect(wrapper.querySelectorAll('.ant-progress-status-success')).toHaveLength(0);
});
it('render out-of-range progress', () => {
const { container: wrapper } = render(<Progress percent={120} />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render strokeWidth of progress', () => {
const { container } = render(<Progress type="circle" percent={30} strokeWidth={50} />);
expect(container).toMatchSnapshot();
});
it('render out-of-range progress with info', () => {
const { container: wrapper } = render(<Progress percent={120} showInfo />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render negative progress', () => {
const { container: wrapper } = render(<Progress percent={-20} />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render negative successPercent', () => {
const { container: wrapper } = render(<Progress percent={50} success={{ percent: -20 }} />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render format', () => {
const { container: wrapper } = render(
<Progress
percent={50}
success={{ percent: 10 }}
format={(percent, successPercent) => `${percent} ${successPercent}`}
/>,
);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render strokeColor', () => {
const { container: wrapper, rerender } = render(
<Progress type="circle" percent={50} strokeColor="red" />,
);
expect(wrapper.firstChild).toMatchSnapshot();
rerender(
<Progress
strokeColor={{
from: '#108ee9',
to: '#87d068',
}}
percent={50}
type="line"
/>,
);
expect(wrapper.firstChild).toMatchSnapshot();
rerender(
<Progress
strokeColor={{
'0%': '#108ee9',
'100%': '#87d068',
}}
percent={50}
type="line"
/>,
);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render normal progress', () => {
const { container: wrapper } = render(<Progress status="normal" />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render trailColor progress', () => {
const { container: wrapper } = render(<Progress status="normal" trailColor="#ffffff" />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render successColor progress', () => {
const { container: wrapper } = render(
<Progress percent={60} success={{ percent: 30, strokeColor: '#ffffff' }} />,
);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render successColor progress type="circle"', () => {
const { container: wrapper } = render(
<Progress percent={60} type="circle" success={{ percent: 30, strokeColor: '#ffffff' }} />,
);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render successColor progress type="dashboard"', () => {
const { container: wrapper } = render(
<Progress percent={60} type="dashboard" success={{ percent: 30, strokeColor: '#ffffff' }} />,
);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render dashboard zero gapDegree', () => {
const { container: wrapper } = render(<Progress type="dashboard" gapDegree={0} />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render dashboard 295 gapDegree', () => {
const { container: wrapper } = render(<Progress type="dashboard" gapDegree={295} />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('render dashboard 296 gapDegree', () => {
const { container: wrapper } = render(<Progress type="dashboard" gapDegree={296} />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('get correct line-gradient', () => {
expect(handleGradient({ from: 'test', to: 'test' }).background).toBe(
'linear-gradient(to right, test, test)',
);
expect(handleGradient({}).background).toBe('linear-gradient(to right, #1677FF, #1677FF)');
expect(handleGradient({ from: 'test', to: 'test', '0%': 'test' }).background).toBe(
'linear-gradient(to right, test 0%)',
);
});
it('sort gradients correctly', () => {
expect(sortGradient({ '10%': 'test10', '30%': 'test30', '20%': 'test20' })).toBe(
'test10 10%, test20 20%, test30 30%',
);
expect(sortGradient({ '10%': 'test10', '30%': 'test30', '20%': 'test20', dummy: 'test' })).toBe(
'test10 10%, test20 20%, test30 30%',
);
});
it('should show success status when percent is 100', () => {
const { container: wrapper } = render(<Progress percent={100} />);
expect(wrapper.querySelectorAll('.ant-progress-status-success')).toHaveLength(1);
});
// https://github.com/ant-design/ant-design/issues/15950
it('should show success status when percent is 100 and status is undefined', () => {
const { container: wrapper } = render(<Progress percent={100} status={undefined} />);
expect(wrapper.querySelectorAll('.ant-progress-status-success')).toHaveLength(1);
});
// https://github.com/ant-design/ant-design/pull/15951#discussion_r273062969
it('should show success status when status is invalid', () => {
const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
const { container: wrapper } = render(
<Progress percent={100} status={'invalid' as ProgressProps['status']} />,
);
expect(wrapper.querySelectorAll('.ant-progress-status-success')).toHaveLength(1);
errorSpy.mockRestore();
});
it('should support steps', () => {
const { container: wrapper } = render(<Progress steps={3} />);
expect(wrapper.firstChild).toMatchSnapshot();
});
it('steps should be changeable', () => {
const { container: wrapper, rerender } = render(<Progress steps={5} percent={60} />);
expect(wrapper.querySelectorAll('.ant-progress-steps-item-active').length).toBe(3);
rerender(<Progress steps={5} percent={40} />);
expect(wrapper.querySelectorAll('.ant-progress-steps-item-active').length).toBe(2);
});
it('steps should be changeable when has strokeColor', () => {
const { container: wrapper, rerender } = render(
<Progress steps={5} percent={60} strokeColor="#1677ff" />,
);
expect(
wrapper.querySelectorAll<HTMLDivElement>('.ant-progress-steps-item')[0].style.backgroundColor,
).toBe('rgb(22, 119, 255)');
rerender(<Progress steps={5} percent={40} strokeColor="#1677ff" />);
expect(
wrapper.querySelectorAll<HTMLDivElement>('.ant-progress-steps-item')[2].style.backgroundColor,
).toBe('');
expect(
wrapper.querySelectorAll<HTMLDivElement>('.ant-progress-steps-item')[1].style.backgroundColor,
).toBe('rgb(22, 119, 255)');
});
it('steps should support trailColor', () => {
const { container: wrapper } = render(<Progress steps={5} percent={20} trailColor="#1890ee" />);
expect(
wrapper.querySelectorAll<HTMLDivElement>('.ant-progress-steps-item')[1].style.backgroundColor,
).toBe('rgb(24, 144, 238)');
});
it('should display correct step', () => {
const { container: wrapper, rerender } = render(<Progress steps={9} percent={22.22} />);
expect(wrapper.querySelectorAll('.ant-progress-steps-item-active').length).toBe(2);
rerender(<Progress steps={9} percent={33.33} />);
expect(wrapper.querySelectorAll('.ant-progress-steps-item-active').length).toBe(3);
rerender(<Progress steps={9} percent={44.44} />);
expect(wrapper.querySelectorAll('.ant-progress-steps-item-active').length).toBe(4);
});
it('steps should have default percent 0', () => {
const { container } = render(<ProgressSteps steps={0} />);
expect(container.firstChild).toMatchSnapshot();
});
it('should warning if use `progress` in success', () => {
const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
render(<Progress percent={60} success={{ progress: 30 }} />);
expect(errorSpy).toHaveBeenCalledWith(
'Warning: [antd: Progress] `success.progress` is deprecated. Please use `success.percent` instead.',
);
});
it('should warnning if use `width` prop', () => {
const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
render(<Progress percent={60} width={100} />);
expect(errorSpy).toHaveBeenCalledWith(
'Warning: [antd: Progress] `width` is deprecated. Please use `size` instead.',
);
});
it('should warnning if use `strokeWidth` prop in type Line', () => {
const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
render(<Progress percent={60} strokeWidth={10} />);
expect(errorSpy).toHaveBeenCalledWith(
'Warning: [antd: Progress] `strokeWidth` is deprecated. Please use `size` instead.',
);
});
it('should warning if use `progress` in success in type Circle', () => {
const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
render(<Progress percent={60} success={{ progress: 30 }} type="circle" />);
expect(errorSpy).toHaveBeenCalledWith(
'Warning: [antd: Progress] `success.progress` is deprecated. Please use `success.percent` instead.',
);
});
it('should warnning if pass number[] into `size` in type Circle', () => {
const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
render(<Progress size={[60, 20]} type="circle" />);
expect(errorSpy).toHaveBeenCalledWith(
'Warning: [antd: Progress] Type "circle" and "dashboard" do not accept array as `size`, please use number or preset size instead.',
);
});
it('should not warning if not pass the `size` prop in type Circle', () => {
const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
errorSpy.mockClear();
render(<Progress type="circle" />);
expect(errorSpy).not.toHaveBeenCalled();
});
it('should warnning if pass number[] into `size` in type dashboard', () => {
const errorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
render(<Progress size={[60, 20]} type="dashboard" />);
expect(errorSpy).toHaveBeenCalledWith(
'Warning: [antd: Progress] Type "circle" and "dashboard" do not accept array as `size`, please use number or preset size instead.',
);
});
it('should update the percentage based on the value of percent', () => {
const Content: React.FC = () => {
const [percent, setPercent] = useState(0);
return (
<>
{ProgressTypes.map((type) => (
<Progress key={type} type={type} percent={percent} success={{ percent: 30 }} />
))}
<button type="button" onClick={() => setPercent(10)}>
Change Percent
</button>
</>
);
};
const { container } = render(<Content />);
expect(container.querySelectorAll('[title="0%"]')).toHaveLength(ProgressTypes.length);
// Change Percent
fireEvent.click(container.querySelectorAll('button')[0]);
expect(container.querySelectorAll('[title="10%"]')).toHaveLength(ProgressTypes.length);
});
describe('github issues', () => {
// https://github.com/ant-design/ant-design/issues/30685
it('Rendered more hooks than during the previous render', () => {
expect(() => {
const { rerender } = render(
<Progress percent={60} success={{ percent: 0 }} type="circle" />,
);
rerender(<Progress percent={60} success={{ percent: 10 }} type="circle" />);
}).not.toThrow();
});
// https://github.com/ant-design/ant-design/issues/40377
it('should not throw error when percent is null', () => {
expect(() => {
render(<Progress percent={null as unknown as number} />);
}).not.toThrow();
});
});
describe('progress size', () => {
const App = (props: { size: ProgressProps['size'] }) => (
<>
<Progress size={props.size} />
<Progress size={props.size} steps={3} />
<Progress type="circle" size={props.size} />
<Progress type="dashboard" size={props.size} />
</>
);
const { container, rerender } = render(<App size={30} />);
expect(container.querySelector('.ant-progress-line .ant-progress-outer')).toHaveStyle({
width: '30px',
});
expect(container.querySelector('.ant-progress-steps .ant-progress-steps-item')).toHaveStyle({
width: '30px',
height: '30px',
});
expect(container.querySelectorAll('.ant-progress-circle .ant-progress-inner')[0]).toHaveStyle({
width: '30px',
height: '30px',
});
expect(container.querySelectorAll('.ant-progress-circle .ant-progress-inner')[1]).toHaveStyle({
width: '30px',
height: '30px',
});
rerender(<App size={[60, 20]} />);
expect(container.querySelector('.ant-progress-line .ant-progress-outer')).toHaveStyle({
width: '60px',
height: '20px',
});
expect(container.querySelector('.ant-progress-steps .ant-progress-steps-item')).toHaveStyle({
width: '60px',
height: '20px',
});
expect(container.querySelectorAll('.ant-progress-circle .ant-progress-inner')[0]).toHaveStyle({
width: '60px',
height: '60px',
});
expect(container.querySelectorAll('.ant-progress-circle .ant-progress-inner')[1]).toHaveStyle({
width: '60px',
height: '60px',
});
});
it('no strict warning', () => {
const errSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
const { rerender } = render(
<Tooltip title="当前已使用60%">
<Progress percent={60} type="circle" />
</Tooltip>,
);
rerender(
<Tooltip title="当前已使用60%">
<Progress percent={60} type="circle" />
</Tooltip>,
);
expect(errSpy).not.toHaveBeenCalledWith(
expect.stringContaining('findDOMNode is deprecated in StrictMode'),
);
errSpy.mockRestore();
});
it('should be accessible', () => {
const { container: wrapper, rerender } = render(
<Progress percent={70} aria-label="My progress" />,
);
let progress = wrapper.querySelector('[role="progressbar"]');
expect(progress).toHaveAttribute('aria-label', 'My progress');
expect(progress).toHaveAttribute('aria-valuenow', '70');
rerender(
<>
<span id="progressLabel">My progress</span>
<Progress percent={90} aria-labelledby="progressLabel" />
</>,
);
progress = wrapper.querySelector('[role="progressbar"]');
expect(progress).toHaveAttribute('aria-labelledby', 'progressLabel');
expect(progress).toHaveAttribute('aria-valuenow', '90');
});
it('circle progress should accept steps', () => {
const { container } = render(<Progress percent={70} steps={{ count: 5, gap: 5 }} />);
expect(container.firstChild).toMatchSnapshot();
});
it('circle progress steps can be number', () => {
const { container } = render(<Progress percent={70} steps={5} />);
expect(container.firstChild).toMatchSnapshot();
});
});