Skip to content

nanxiaobei/antd-img-crop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

56e4fe6 ยท Feb 20, 2025
Feb 13, 2025
Jan 1, 2023
Aug 9, 2022
Dec 29, 2023
Jan 1, 2023
Sep 16, 2023
Mar 4, 2023
Dec 20, 2024
Dec 20, 2024
Dec 20, 2024
Dec 20, 2024
Mar 19, 2023
Sep 16, 2023
Mar 19, 2023
Nov 19, 2022

Repository files navigation

Link in bio to widgets, your online home screen. โžซ ๐Ÿ”— kee.so


antd-img-crop

An image cropper for Ant Design Upload

npm npm npm bundle size GitHub npm type definitions

English | ็ฎ€ไฝ“ไธญๆ–‡

Install

pnpm add antd-img-crop
# or
yarn add antd-img-crop
# or
npm i antd-img-crop

Usage

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

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

Edit antd-img-crop

Props

Prop Type Default Description
quality number 0.4 Cropped image quality, 0 to 1
fillColor string 'white' Fill color for cropped image
zoomSlider boolean true Enable zoom
rotationSlider boolean false Enable rotation
aspectSlider boolean false Enable aspect
showReset boolean false Show reset button to reset zoom & rotation & aspect
resetText string Reset Reset button text
aspect number 1 / 1 Aspect of crop area , width / height
minZoom number 1 Minimum zoom
maxZoom number 3 Maximum zoom
minAspect number 0.5 Minimum aspect
maxAspect number 2 Maximum aspect
cropShape string 'rect' Shape of crop area, 'rect' or 'round'
showGrid boolean false Show grid of crop area (third-lines)
cropperProps object - react-easy-crop props (* existing props cannot be overridden)
modalClassName string '' Modal classname
modalTitle string 'Edit image' Modal title
modalWidth number string Modal width
modalOk string Ok button text
modalCancel string Cancel button text
onModalOk function - Callback of click ok button
onModalCancel function - Callback of click cancel button (or modal mask & top right "x")
modalProps object Ant Design Modal props (* existing props cannot be overridden)
beforeCrop function - Callback before crop modal, if return false or reject(), modal will not open

FAQ

ConfigProvider not work?

Try to set libraryDirectory('es' or 'lib') to babel-plugin-import config, see which one will work.

module.exports = {
  plugins: [
    ['import', { libraryName: 'antd', libraryDirectory: 'es', style: true }],
  ],
};

No style? (only antd<=v4)

If you use antd<=v4 + babel-plugin-import, and no Modal or Slider were imported, please import these styles manually:

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

License

MIT License (c) nanxiaobei