Awesome Open Source
Awesome Open Source


An image cropper for Ant Design Upload.

npm npm npm bundle size GitHub

English | 简体中文


Live demo


yarn add antd-img-crop


import ImgCrop from 'antd-img-crop';
import { Upload } from 'antd';

const Demo = () => (
    <Upload>+ Add image</Upload>


Prop Type Default Description
aspect number 1 / 1 Aspect of crop area , width / height
shape string 'rect' Shape of crop area, 'rect' or 'round'
grid boolean false Show grid of crop area (third-lines)
quality number 0.4 Image quality, 0 ~ 1
fillColor string white Fill color when cropped image smaller than canvas
zoom boolean true Enable zoom for image
rotate boolean false Enable rotate for image
minZoom number 1 Minimum zoom factor
maxZoom number 3 Maximum zoom factor
modalTitle string 'Edit image' Title of modal
modalWidth number | string 520 Width of modal in pixels number or percentages
modalOk string 'OK' Text of confirm button of modal
modalCancel string 'Cancel' Text of cancel button of modal
beforeCrop function - Call before modal open, if return false, it'll not open
cropperProps object - Props of react-easy-crop (* existing props cannot be overridden)


To prevent overwriting the custom styles to antd, antd-img-crop does not import the style files of components.

Therefore, if your project configured babel-plugin-import, and not use Modal or Slider, you need to import the styles yourself:

import 'antd/es/modal/style';
import 'antd/es/slider/style';


MIT License (c) nanxiaobei

Pitiless Ads

If you use WeChat, please try "FUTAKE". It's a WeChat mini app for your inspiration moments. 🌈


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
javascript (70,924
react (5,567
image (507
antd (140
upload (118
ant-design (112
image-cropper (21