Skip to content

burczu/CropOnTheFly

Repository files navigation

CropOnTheFly

A jQuery plugin which allows you to crop images on the fly (while loading and resizing of the browser window).

Installation:

Just download cropOnTheFly.js file (or cropOnTheFly.min.js if you want minified version) and add it to your page.

Usage example:

$('img').cropOnTheFly(options);

where 'options' is an object similar to this:

var options = {
    height: 250,
    width: 400,
    verticalPosition: 'center',
    horizontalPosition: 'center',
    afterCrop(parameter) {
        alert('height: ' + parameter.height);
    }
}

Explanation of each property below:

  • height: default value is nul which means that the full height of the image will be used; you can also set a fixed value in pixels
  • width: default value is null, it works the same as for height property
  • verticalPosition: default value is 'top' which means that after cutting the height it will show the top segment of the image; other options are 'center' and 'bottom'; you could also use numeric values where 0 means 'top'
  • horizontalPosition: default value is 'left' which means that that after cutting the width it will show the left segment of the image; other options are 'center' and 'right'; you could also use numeric values where 0 means 'left'
  • afterCrop: default value is an empty function; this is callback function which will be called just after cropping is finished; the parameter taken by this function is an object which contains calculations and objects used to crop; this object can look like this:
var parameters = {
    height: 250,
    width: 400,
    top: -175,
    left: -75,
    element: {},
    parent: {}
}

Explanation of each property below:

  • height: calculated height of the image
  • width: calculated width of the image
  • top: calculated position of the image; this value is set to 'top' CSS property
  • left: calculated position of the image; this value is set to 'left' CSS property
  • element: object which contains 'img' HTML element
  • parent: object which contains 'div' HTML element; this element is an injected container which contains image

About

A jQuery plugin which allows you to crop images on the fly

Resources

Stars

Watchers

Forks

Packages

No packages published