From jQuery JavaScript Library

Contents 1 Overview 2 API Documentation 3 Download 4 Support 5 Browser Support 6 License

Overview

Batch is a jQuery plugin that gives you the ability to batch the results of any jQuery method or plugin into an Array. In its most basic form you can use it like this.

$('div').batch('offset'); // => [{ top: 3, left: 3}, { top: 10, left: 30 }]

You can pass along the arguments as you normally would.

$('div').batch('css', 'position'); // => ['relative', 'absolute']

The batch plugin automatically creates plural versions of the getter methods within jQuery's core. That means you can do the following.

$('div').offsets(); // => [{ top: 3, left: 3}, { top: 10, left: 30 }]

This is a list of the pluralized core methods.

• attrs
• datas
• heights
• htmls
• innerHeights
• innerWidths
• offsets
• outerHeights
• outerWidths
• positions
• scrollLefts
• scrollTops
• styles
• texts
• vals
• widths

The batch plugin also provides a way for you to register other plugins to be pluralized (just adds an s).

$.batch.registerPlugin('myPlugin');

This will create a method called myPlugins that will return a Array of its results.

You can pass in multiple methods at a time if you want.

$.batch.registerPlugin('myPlugin', 'thatPlugin', 'thisPlugin');

This will create pluralized versions of each plugin passed in.

You can also manually set what the pluralized version should be named by passing in an Array of the plugin name and then the desired pluralized name.

$.batch.registerPlugin(['myPlugin', 'myPluralizedPlugin']);

This will use myPluralizedPlugin as the name, instead of myPlugins.

API Documentation

Download

The latest release can be downloaded from the project page.

Or you can live on the edge and just pull from Git: http://github.com/brandonaaron/batch/tree/master

Support

Please report bugs, features, patches or requests for support via the project page.

Browser Support

Batch is tested in those browsers that jQuery supports. See browser compatibility for more info.

License

Batch is Dual licensed under the MIT (http://www.opensource.org/licenses/mit-license.php) and GPL (http://www.opensource.org/licenses/gpl-license.php) licenses. Copyright © 2009 Brandon Aaron (http://brandonaaron.net/).