Handlebars-extd NPM

Handlebars extension

This package provides a set of powerful and convenient Handlebars helpers to enhance your templating experience. It simplifies common tasks and adds useful functionalities to your Handlebars templates.

Documentation

Handlebars extension documentation can be found here.

Installation

npm install --save handlebars-extd

Release Notes

All changes can be found here.

1.0.13 - 2025/2/4
- Fixed a typo in the stripTags sample code.

1.0.12 - 2025/2/4

Added a helper to replace HTML tags in a string. See the stripTags documentation for more details.

Example:

// results in: lorem ipsum dolor sit amet
hbs.compile("{{{stripTags html}}}")({
    html: '<a href="https://example.com">lorem ipsum <strong>dolor</strong> <em>sit</em> amet</a>',
});

// results in: lorem ipsum <strong>dolor</strong> sit amet
hbs.compile("{{{stripTags html allowedTags}}}")({
    html: '<a href="https://example.com">lorem ipsum <strong>dolor</strong> <em>sit</em> amet</a>',
    allowedTags: ['strong'],
});

// results in: 🍩lorem ipsum 🍩dolor🍩 🍩sit🍩 amet🍩
hbs.compile("{{{stripTags html allowedTags replacement}}}")({
    html: '<a href="https://example.com">lorem ipsum <strong>dolor</strong> <em>sit</em> amet</a>',
    allowedTags: [],
    replacement: '🍩',
});

1.0.11 - 2025/1/14

findObjectInArray Handlebars helper: This helper allows you to find an object in an array based on a specified field name and value.

// results in: "Item A"
const items = [{id: 123, name: 'Item A'}, {id: 456, name: 'Item B'}];
hbs.compile(
    `{{#each items}}
        {{#if (eq id 123)}}
            {{lookup (findObjectInArray ../items 'id' id) 'name'}}
        {{/if}}
    {{/each}}`)({items});