grunt-image-preload
The best Grunt plugin ever.
Getting Started
This plugin requires Grunt ~0.4.2
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-image-preload --save-devOnce the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-image-preload');The "image_preload" task
Overview
In your project's Gruntfile, add a section named image_preload to the data object passed into grunt.initConfig().
grunt.initConfig({
image_preload: {
options: {
jsvar:"PRELOADER", //optional
root:"http://example.com/", //optional
inlineFile:null,
inlineLoad:null,
rev:false
},
files:[{
cwd: "test/fixtures/images",
src: "**/*.{jpg,jpeg,png,gif}"
}],
process:{
files:[{
cwd: "test/fixtures/",
src: "index.html",
dest: "tmp/"
}]
}
},
});Options
options.jsvar
Type: String
Default value: PRELOADER
This is name of global js variable which will be integrated to *.html document "window.PRELOADER"
options.root
Type: String
Default value: ``
Root of all resources
files
Type: Object
Grunt path to all processing resources
process.files
Type: Object
Grunt path from processing resources to destination of generator
options.inlineFile
Type: String
Default value: null
Task generate js file whick located by options.inlineFile
options.inlineLoad
Type: String
Default value: options.inlineFile
If you want inject file automaticly, script inline in html tag
<script type="text/javascript" src="#{options.inlineLoad}"></script>options.rev
Type: String
Default value: false
If you use functionality like plugin grunt-rev, set value
true and processing filepath by function options.reduceRev
which reduce revision
options.reduceRev
Type: String
Default value: Function which reduce revision from file path
while processin tree of files
Usage Examples
Default Options
In this example, task search all files in folder "test/fixtures/images" according mask "**/*.{jpg,jpeg,png,gif}" and in file test/fixtures/index.html injected js code with array of resources and put result in tmp/index.html
grunt.initConfig({
image_preload: {
options: {
jsvar:"PRELOADER",
root:"http://example.com/"
},
files:[{
cwd: "test/fixtures/images",
src: "**/*.{jpg,jpeg,png,gif}"
}],
process:{
files:[{
cwd: "test/fixtures/",
src: "index.html",
dest: "tmp/"
}]
}
},
});from index.html
<html>
<head>
<title></title>
</head>
<body></body>
</html>generated
<html>
<head>
<title></title>
<!--preloader:js--><script>window.PRELOADER = funtion(){...};</script><!--endpreloader:js--></head>
<body></body>
</html>using ClientSide code
var preloader = new window.PRELOADER({
threads:4,
progress: function(pro, src, type, time) {
return log("progress(" + type + ") " + time + ": " + pro + "% - " + src);
},
complete: function() {
return log("COMPLETE");
}
});
preloader.load();
preloader.getFile("path/to/file/fulename.jpg") window.PRELOADER - or name using in jsvar
Type: Function
Create prototype for loading resourses
load - instanse method
Type: Function
start load images
options.threads
Type: Integer
number of parralel loading
options.progress
Type: function
callback execute every type where resource is success/fail loaded
params:
pro - procents
src - path to resource
type - type of responce
time - time since start of loading
options.complete
Type: function
callback execute where loading is complete
getFile(path,_def)
Type: Function
Arguments:
path:String - path to image whithou revision
_def:String - default value
return real path to file
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
Release History
(Nothing yet)