Skip to content

Recras/angular-images-resizer

 
 

Repository files navigation

Angular-image-resizer

Build Status Coverage Status devDependency Status

This is a simple Angular service which resizes images client-side. With this component, you will liberate some resources on your server! Let your client work for you, and save bandwidth. If you don't care about supporting old browsers then this component is for you (see below for browser support).

You can test this module on this site example: https://fberthelot.github.io/angular-images-resizer/

Breaking changes in the 2.0.0 version

In this version the resizeService.resizeImage function return a promise. No need to use a callback anymore.

Get started

Add this module to your project with bower or npm:

bower install angular-images-resizer
npm install angular-images-resizer

Add the component to your app:

angular.module('app', ['images-resizer']); 

Then simply add the service to your code and start resizing your images :

angular.module('app', function ($document, $log, $scope, resizeService) {
  resizeService
    .resizeImage('resources/imageToResize', {
        size: 100, 
        sizeScale: 'kb'
        // Other options ...
    })
    .then(function(image){    
      // Add the resized image into the body
      var imageResized = document.createElement('img');
      imageResized.src = image;
      $document[0].querySelector('body').appendChild(imageResized);
    })
    .catch($log.error); // Always catch a promise :)

Availables functions

Click here to see the Full documentation

resizeImage

This is the main function of this service. The function take 3 argument, the src of the image, the options to resize the image and the callback. The src can be an base 64image.

Options
  • height: desired height of the resized image
  • width: desired width of the resized image
  • size: desired size of the resized image (Size are by default in bytes)
  • sizeScale: 'b' || 'kb' || 'mb' || 'gb'
  • step: number of step to resize the image, by default 3. Bigger the number, better is the final image. Bigger the number, bigger the time to resize is.
  • outputFormat: specify the image type. Default value is 'image/jpeg'. Check this page to see what format are supported.
  • outputAs: 'dataUrl' (default) || 'blob'
  • crossOrigin: Specify the crossOrigin of the image to resize

Compatibility

This module uses canvas, so it's only compatible with:

  • Firefox: 3.6+
  • Chrome: 4+
  • Internet Explorer: 9+
  • Edge: any
  • Safari: 4+
  • iOS: 3+
  • Android browser 3.2+
  • Chrome for Android: 18+

Blob support is limited at the moment. Support is as follows:

  • Firefox: 19+
  • Chrome: 50+
  • Internet Explorer: no support
  • Edge: no support
  • Safari: no support
  • iOS: no support
  • Android browser no support
  • Chrome for Android: 50+

I need help

  • This angular component doesn't work on iPhones with iOS 8.1, but works on iPad and iPod touch with iOS 8.1. I still don't understand why, if someone has an explanation, it would be nice.
  • I don't know how to test the resizeLocalPic service. If someone can help me on this subject. Thanks

Special thanks

  • This module is widely inspired by this article of the liip blog.

Licence

MIT

About

Resize images client-side is now possible with this angular module

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 88.0%
  • HTML 10.0%
  • Shell 1.8%
  • CSS 0.2%