An AngularJS directive for ImageEngine
ImageEngine is an intelligent image CDN for optimizing, compressing and resizing images. ImageEngine will enhance your responsive images by enabling support for HTTP2, automatic webp conversion, Client Hints and more.
It is likely that ImageEngine will shave off 50-60% of data traffic generated by images on your site. To better support mobile devices, ImageEngine relies on WURFL for server side device detection in cases where responsive images and Client Hints fall short.
Registration is required to get the most out of ImageEngine.
Images weight is by far the most important challenge to address when optimizing a web page for the plethora of devices on the web today. This is why ImageEngine will instantly give your users a better experience by reducing load time of your page. Not to mention the reduced data cost.
ImageEngine works as a CDN proxy. By referencing the ImageEngine servers and providing the full URL to the original image as a parameter, ImageEngine will identify the device, and its capabilities, and resize and optimize the image accordingly.
The plugin will enable Client Hint support for your site. Client Hints, with information about the viewport size, device pixel ratio and actual image size, are added to the image request (HTTP header) enabling ImageEngine to resize the image with surgical precision.
HTTP will give additional performance improvement on the network level. ImageEngine supports HTTP2 over SSL, which means that if you serve your sites and images by https://
, ImageEngine will automatically serve all images over HTTP2.
WebP is a lightweight image format with great quality. WebP is well supported by browsers. ImageEngine will detect if the end user's browser supports WebP and automatically convert any format to WebP to increase performance.
yarn add image-engine-angular
- Include
image-engine-angular.js
. It should be located atnode_modules/src/image-engine-angular.js
npm i image-engine-angular --save
- Include
image-engine-angular.js
. It should be located atnode_modules/src/image-engine-angular.js
bower install image-engine-angular --save
- Include
image-engine-angular.js
. It should be located atbower_components/src/image-engine-angular.js
- Download Latest Version and extract the archive.
- Include
image-engine-angular.js
. It should be located atarchive_path/src/image-engine-angular.js
- Include the image-engine-angular directive dependency on your angular module:
var app = angular.module("demoapp", ["image-engine-angular"]);
app.config(function (imgEngConfigProvider) {
imgEngConfigProvider.setToken('your-token');
});
Note: sign up here to get your token
- Include the markup directive on your HTML page, like this:
<img-eng src="http://yourserver.com/image.png"></img-eng>
or if you want to use interpolation:
<img-eng src="{{myUrl}}"></img-eng>
where {{myUrl}} is the url of the trusted image to load.
Check the ImageEngine Documentation for the list of available settings.
<img-eng src="http://yourserver.com/image.png"></img-eng>
<img-eng src="http://yourserver.com/image.png" pc="20"></img-eng>
<img-eng src="http://yourserver.com/image.png" w="300"></img-eng>
<img-eng src="http://yourserver.com/image.png" w="200" h="200" m="letterbox_000000_100"></img-eng>
- Run:
npm start
- Browse:
http://localhost:8000/demo/index.html
$ npm test
Licensed under the MIT license. (See the LICENSE file)
Copyright © ScientiaMobile, Inc.