@thoughtindustries/co-nested-hbs
v2.0.0
Published
Generator-based Handlebars templates for nested layouts.
Downloads
1,788
Readme
co-nested-hbs
Generator-based Handlebars templates for nested layouts.
koa-hbs is really great, but doesn't support nested layouts. Adding nested layouts to koa-hbs would unfortunately be a complete rewrite.
co-nested-hbs supports (nested) layouts, helpers, and partials.
Installation
$ npm install co-nested-hbsExample
views/overall_layout.hbs
<html>
<head>
<title>{{title}}</title>
</head>
<body>
{{{body}}}
</body>
</html>views/simple_theme.hbs
<header>
Simple Theme!
</header>
<div class="simple_theme">
{{{body}}}
</div>
<footer>
Footer!
</footer>views/home.hbs
<p>Welcome {{name}}!<p>var r = require('rethinkdb');
var view = require('co-nested-hbs');
var html = await view.render('home', 'simple_theme', 'overall_layout', { title: 'Hello World!' });html output would be:
<html>
<head>
<title>Hello World!</title>
</head>
<body>
<header>
Simple Theme!
</header>
<div class="simple_theme">
<p>Welcome Bob!<p>
</div>
<footer>
Footer!
</footer>
</body>
</html>Usage
Partials are automatically registered if their filename matches _*.hbs, directory is ignored.
function *() {
var view = require('co-nested-hbs')('view_path/goes/here', {
layout: 'layout_file', // specify implied layout (or layouts) to be added to each render() call.
partialsPath: 'path_to_partials',
cache: true
});
// single template rendering
var html = yield view.render('template', {local: 'variable'});
// register helper
view.registerHelper('link-to', function(url, text) {
return "<a href='" + this.url + "'>" + this.text + "</a>";
});
// render the following templates in a chain, building the 'nest'
var html = yield view.render('first_render', 'second_render', 'third_render');
// locals can be applied to all templates when they are rendered
var html = yield view.render('first_render', 'second_render', 'third_render', {title: 'Hello World!'}, {global_local: 'applied to all templates'});
}License
MIT