handlebars-plugin-grouping

A handlebars grouping iterator plugin to group collections into groups of definable size.

##Template Usage

An example template to render a collection of thumbnails into a bootstrap grid row of 6 thumbnails per row.

{{#grouping thumbnails 6}}
<div class="row">
	<div class="row-fluid" title="Row {{@index}} of {{@groups}} contains {{@size}} thumbnails.">
		{{#each this}}
			<div class="col-md-2">
				<img id="thumbnail-{{id}}" src="{{src}}" title="{{title}}"/>
			</div>
		{{/each}}
	</div>
</div>
{{/grouping}}

##Node.js

Installation:

npm install handlebars-plugin-grouping --save

Example:

var grouping = require('handlebars-plugin-grouping');
var exphbs  = require('express-handlebars');

var hbs = exphbs.create({
	helpers: {
		grouping: grouping
	}
});

##Browser

Load the script after the handlebars runtime.

<script type="text/javascript" src=".../handlebars.runtime.js"></script>
<script type="text/javascript" src=".../handlebars-plugin-grouping.js"></script>

##License MIT