Simple-React-Cropper

Demo

This is the tiny and simple image cropper & resizer based on Cropper.js. Simply it is wrapped to React Component to allow to use more easily in React project.

There are many functions of Cropper.js but this module is simplified with main features in purpose of avatar image crop & resize in most user-profile web page.

Features

1. Crop and Resize the images in Web canvas (powered by Cropper.js).
2. Handle the cropped and resized images with function props.
3. Style the container of crop canvas.
4. Typescript support

Install

$ npm i simple-react-cropper

# or

$ yarn add simple-react-cropper

Example

import React from "react";
import ReactDOM from "react-dom";
import Cropper from "simple-react-cropper";

const uploadToServer = blob => {
  console.log(blob);
};

const afterCrop = () => {
  console.log("close cropper");
};

const Root = () => (
  <div className="container-demo">
    <Cropper
      aspectRatio={4 / 4}
      width={500}
      height={500}
      upload={uploadToServer}
      afterCrop={afterCrop}
      containerStyle={{ maxHeight: "80vh", borderRadius: "10px" }}
    />
  </div>
);

ReactDOM.render(<Root />, document.getElementById("root"));

Props

Props	Type	required	Default	Descriptioin
aspectRatio	number	true	NaN	Define the fixed crop box ratio. By default, the crop box has free ratio
width	number	false	500	The width of output image
height	number	false	500	The height of output image
upload	function	true	undefined	The function to handle the output (blob type)
afterCrop	function	false	undefined	The function to be called after confirming cropping
fillColor	string	false	"#FFF"	The color to be filled in blank area after crop
containerStyle	React.CSSProperties	false	undefined	The object to style the parent container