Goodybag Handlebars Helpers

Lightweight collection of useful handlebars helpers for the browser or server.

Install

bower install gb-handlebars-helpers
npm install gb-handlebars-helpers

Usage

Register the helpers:

var Handlebars = require('handlebars');
var helpers = require('gb-handlebars-helpers');

// register all the helpers
helpers.register(Handlebars);

// or cherry pick what you need
helpers.register(Handlebars, ['truncate', 'dollars']);

Using helpers:

// use a helper directly
console.log(Handlebars.helpers.dollars(234)); // '2.34'

// or in a template
var templateStr = 'You balance: ${{dollars amount}}';
var template = Handlebars.compile(templateStr);
var output = template({ amount: 234 }); // 'Your balance: $2.34'

API

helpers.register(Handlebars)

Register all helpers

helpers.register(Handlebars, [ a, b, ... ])

Register with a list of helper names

helpers.register(Handlebars, a, b, ...)

Register helpers by passing in parameters

helpers.unregister(Handlebar)

helpers.unregister(Handlebars, [ a, b, ... ])

helpers.unregister(Handlebars, a, b, ... )

Unregister using same signatures as .register

Helpers

Comparison

• eq
• dneq
• lt
• lte
• gt
• gte

Math

• add
• subtract
• multiply
• divide
• intDivide
• mod

String manipulation

• truncate
• capitalize
• uppercase
• lowercase

Currency

• dollars
• pennies

Datetime (WIP)

• datepart
• timepart
• formatDatetime

Bolded helpers can be used for conditional templating blocks.

For example:

{{#gt age 30}}
You are old!
{{else}}
Such youth!
{{/gt}}

License

MIT