A simple jQuery image cropping plugin. As of v4.0.0, the core code of Cropper is replaced with Cropper.js.
- Demo
- Cropper.js - JavaScript image cropper (recommended)
- jquery-cropper - A jQuery plugin wrapper for Cropper.js (recommended for jQuery users to use this instead of Cropper)
dist/
├── cropper.css
├── cropper.min.css (compressed)
├── cropper.js (UMD)
├── cropper.min.js (UMD, compressed)
├── cropper.common.js (CommonJS, default)
└── cropper.esm.js (ES Module)
npm install cropper jqueryInclude files:
<scriptsrc="/path/to/jquery.js"></script><!-- jQuery is required --><linkhref="/path/to/cropper.css" rel="stylesheet"><scriptsrc="/path/to/cropper.js"></script>Initialize with $.fn.cropper method.
<!-- Wrap the image or canvas element with a block element (container) --><div><imgid="image" src="picture.jpg"></div>/* Limit image width to avoid overflow the container */img {
max-width:100%; /* This rule is very important, please do not ignore this! */
}var$image=$('#image');$image.cropper({aspectRatio: 16/9,crop: function(event){console.log(event.detail.x);console.log(event.detail.y);console.log(event.detail.width);console.log(event.detail.height);console.log(event.detail.rotate);console.log(event.detail.scaleX);console.log(event.detail.scaleY);}});// Get the Cropper.js instance after initializedvarcropper=$image.data('cropper');See the available options of Cropper.js.
$().cropper(options);See the available methods of Cropper.js.
$().cropper('method',argument1,,argument2, ...,argumentN);See the available events of Cropper.js.
$().on('event',handler);If you have to use other plugin with the same namespace, just call the $.fn.cropper.noConflict method to revert to it.
<scriptsrc="other-plugin.js"></script><scriptsrc="cropper.js"></script><script>$.fn.cropper.noConflict();// Code that uses other plugin's "$().cropper" can follow here.</script>It is the same as the browser support of Cropper.js. As a jQuery plugin, you also need to see the jQuery Browser Support.
Please read through our contributing guidelines.
Maintained under the Semantic Versioning guidelines.