This is a sample method to show a completeHandler, which is optionally specified by the return object in the preloadHandler. This sample provides a completeHandler to the LoadItem. This method is called after the item has completely loaded, but before the fileload event is dispatched from the LoadQueue.

The provided sample also listens for the complete event on the loader it returns to show a different usage.

When a plugin is installed, this method will be called to let PreloadJS know when to invoke the plugin.

PreloadJS expects this method to return an object containing:

• callback: The function to call on the plugin class right before an item is loaded. Check out the preloadHandler method for more information. The callback is automatically called in the scope of the plugin.
• types: An array of recognized PreloadJS load types to handle. Supported load types are "binary","image", "javascript", "json", "jsonp", "sound", "svg", "text", and "xml".
• extensions: An array of strings containing file extensions to handle, such as "jpg", "mp3", etc. This only fires if an applicable type handler is not found by the plugin.

Note that currently, PreloadJS only supports a single handler for each extension or file type.

Example

 // Check out the SamplePlugin source for a more complete example.
 SamplePlugin.getPreloadHandlers = function() {
     return {
         callback: SamplePlugin.preloadHandler,
         extensions: ["jpg", "jpeg", "png", "gif"]
     }
 }

If a plugin provides both "type" and "extension" handlers, the type handler will take priority, and will only fire once per file. For example if you have a handler for type=sound, and for extension=mp3, the callback will fire when it matches the type.

This is a sample method to show how to handle the callback specified in the LoadQueue/getPreloadHandlers. Right before a file is loaded, if a plugin for the file type or extension is found, then the callback for that plugin will be invoked. This gives the plugin an opportunity to modify the load item, or even cancel the load. The return value of the callback determines how PreloadJS will handle the file:

• false: Skip the item. This allows plugins to determine if a file should be loaded or not. For example,the plugin could determine if a file type is supported at all on the current system, and skip those that do not.
• true: Continue normally. The plugin will not affect the load.
• AbstractLoader instance: Used as the loader for the content. This is new in 0.6.0.

Since the LoadItem is passed by reference, a plugin can modify as needed, even appending additional data to it. Note that if the src is modified, PreloadJS will automatically update the LoadItem/ext:property property.

Example

 // Cancel a load
 SamplePlugin.preloadHandler = function(loadItem, queue) {
     if (loadItem.id.indexOf("thumb") { return false; } // Don't load items like "image-thumb.png"
     return true;
 }

 // Specify a completeHandler
 SamplePlugin.preloadHandler = function(loadItem, queue) {
     item.completeHandler = SamplePlugin.fileLoadHandler;
 }

 // Check out the SamplePlugin source to see another example.

Note: In 0.4.2 and earlier, instead of a LoadItem, arguments were passed in, and a modified object was returned to PreloadJS. This has been changed to passing a reference to the LoadItem, which can be directly modified.