Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/advanced-cropper/react-advanced-cropper
The react cropper library that embraces power of the advanced cropper core to give the possibility to create croppers that exactly suited for your website design
https://github.com/advanced-cropper/react-advanced-cropper
advanced cropper flexible image image-cropper image-cropping image-manipulation library react react-component react-cropper
Last synced: 2 months ago
JSON representation
The react cropper library that embraces power of the advanced cropper core to give the possibility to create croppers that exactly suited for your website design
- Host: GitHub
- URL: https://github.com/advanced-cropper/react-advanced-cropper
- Owner: advanced-cropper
- License: other
- Created: 2021-10-25T17:23:54.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-02-28T07:42:55.000Z (4 months ago)
- Last Synced: 2024-04-10T00:49:45.378Z (3 months ago)
- Topics: advanced, cropper, flexible, image, image-cropper, image-cropping, image-manipulation, library, react, react-component, react-cropper
- Language: TypeScript
- Homepage: https://advanced-cropper.github.io/react-advanced-cropper/
- Size: 37.2 MB
- Stars: 550
- Watchers: 6
- Forks: 26
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-react-components - react-advanced-cropper - A react cropper library to create the cropper exactly suited for your website design. (UI Components / Form Components)
- awesome-react-components - react-advanced-cropper - A react cropper library to create the cropper exactly suited for your website design. (UI Components / Form Components)
- awesome-react-components- - react-advanced-cropper - A react cropper library to create the cropper exactly suited for your website design. (UI Components / Form Components)
- awesome-react-components - react-advanced-cropper - A react cropper library to create the cropper exactly suited for your website design. (UI Components / Form Components)
- awesome - advanced-cropper/react-advanced-cropper - The react cropper library that embraces power of the advanced cropper core to give the possibility to create croppers that exactly suited for your website design (TypeScript)
- fucking-awesome-react-components - react-advanced-cropper - A react cropper library to create the cropper exactly suited for your website design. (UI Components / Form Components)
README
Documentation /
Examples /
Sandbox
---
:warning: It's the beta version. The API can be changed in the future. Therefore, it's recommended to fix the version with `~`.
---
**React Advanced Cropper** is the advanced library that gives you opportunity to create your own croppers suited for any website design.
It means that you are able to change not only the cropper appearance, you area able to customize its behavior also.
Features:
- full mobile / desktop support
- support [all three main types of croppers](https://advanced-cropper.github.io/react-advanced-cropper/docs/guides/cropper-types) right out of the box
- support both canvas and coordinates modes, minimum and maximum aspect ratios, custom size restrictions
- zoom, rotate, resize image
- auto-zoom, transitions
## Install
```bash
npm install --save react-advanced-cropper
```
```bash
yarn add react-advanced-cropper
```
## Usage
```tsx
import React, { useState } from 'react';
import { CropperRef, Cropper } from 'react-advanced-cropper';
import 'react-advanced-cropper/dist/style.css'
export const GettingStartedExample = () => {
const [image, setImage] = useState(
'https://images.unsplash.com/photo-1599140849279-1014532882fe?ixlib=rb-1.2.1&ixid=eyJhcHBfaWQiOjEyMDd9&auto=format&fit=crop&w=1300&q=80',
);
const onChange = (cropper: CropperRef) => {
console.log(cropper.getCoordinates(), cropper.getCanvas());
};
return (
)
};
```
```
/*
Maybe you need to set the limits for the cropper sizes or its container sizes
otherwise a cropping image will try to fill all available space
*/
.cropper {
height: 600px;
background: #DDD;
}
```
## Cropper
| Prop | Type | Description | Default
| ------------------------- | ------------------ | --------------------------------------------------------------------------- | ---------------
| src | `string` | The cropping image (link / base64) |
| stencilComponent | `Component` | The stencil component | `RectangleStencil`
| stencilProps | `object` | The props for the stencil component | `{}`
| className | `string` | The optional class for the root cropper block |
| imageClassName | `string` | The optional class for the cropping image |
| boundariesClassName | `string` | The optional class for the area. |
| backgroundClassName | `string` | The optional class for the background under the image |
| autoZoom | `boolean` | Enable / disable transitions | `true`
| transitions | `boolean`, `object` | Enable / disable auto zoom | `false`
| stencilSize | `object ` | The size of the stencil in pixels |
| canvas | `boolean` | The flag that indicates if canvas should be used | `true`
| minWidth | `number` | The minimum width of the stencil (percents) |
| minHeight | `number` | The minimum height of the stencil (percents) |
| maxWidth | `number` | The maximum width of the stencil (percents) |
| maxHeight | `number` | The maximum height of the stencil (percents) |
| checkOrientation | `boolean` | Check if EXIF orientation should be checked | `true`
| resizeImage | `boolean`, `object` | The options for the image resizing ([details](https://advanced-cropper.github.io/react-advanced-cropper/docs/components/Cropper#resizeimage)) | `true`
| moveImage | `boolean`, `object` | The options for the image moving ([details](https://advanced-cropper.github.io/react-advanced-cropper/docs/components/Cropper#moveimage)) | `true`
| rotateImage | `boolean`, `object` | The options for the image moving ([details](https://advanced-cropper.github.io/react-advanced-cropper/docs/components/Cropper#rotateImage)) | `false`
| imageRestriction | `string` | Set restrictions for image position ('fillArea' 'fitArea', 'stencil', 'none') | `'fillArea'`
| defaultSize | `object`, `Function` | The function that returns the default size of the stencil or object |
| defaultPosition | `object`, `Function` | The function that returns the default position of the stencil or object |
| defaultTransforms | `object`, `Function` | The function that returns the default image transforms or object |
| wrapperComponent | `Component` | The wrapper component | `CropperWrapper`
| wrapperProps | `object` | The props for the wrapper component | `{}`
| backgroundWrapperComponent| `Component` | The background wrapper component | `CropperBackgroundWrapper`
| backgroundWrapperProps | `object` | The props for the background wrapper component | `{}`
See [the documentation](https://advanced-cropper.github.io/react-advanced-cropper/docs/components/Cropper) for more props and details.
## RectangleStencil
| Prop | Type | Description | Default
| ------------------------ | ------------------- | -------------------------------------------------------------- | ---------------
| aspectRatio | `number` | The aspect ratio |
| minAspectRatio | `number` | The minimum aspect ratio |
| maxAspectRatio | `number` | The maximum aspect ratio |
| className | `string` | The class for root block of the stencil component |
| previewClassName | `string` | The class for the preview component |
| movingClassName | `string` | The class applied when user drag the stencil |
| resizingClassName | `string` | The class applied when user resize the stencil |
| boundingBoxClass | `string` | The class for the bounding box component |
| handlerComponent | `Component` | The handler component |
| handlers | `object` | The object of handlers that should be visible or hidden. |
| handlerClassNames | `object` | The object of custom handler classes |
| handlerWrapperClassNames | `object` | The object of custom handler wrapper classes |
| lineComponent | `Component` | The handler component |
| lines | `object` | The object of lines that should be visible or hidden. |
| lineClassNames | `object` | The object of custom line classes |
| lineWrapperClassNames | `object` | The object of custom line wrapper classes |
See [the documentation](https://advanced-cropper.github.io/react-advanced-cropper/docs/components/RectangleStencil) for more props and details.
## License
The source code of this library is licensed under MIT, the documentation content belongs to [Norserium](https://github.com/Norserium), except the photos that belong to their respective owners.