I've been using Handlebars in Node.js apps for a long time now and while it always gets the job done, sometimes I find it awkward to use.  In particular I miss being able to use expressions and flexible logic flow directly in the templates. I know there's an argument for keeping logic and views separate and that views should be "logicless", but sometimes you just want a bit more control.  The existence of libraries like , suggests that I'm not alone here so I got to thinking... Swag What would a JavaScript enabled template language with a similar syntax to Handlerbars look like? In the end I came up with Moe-js: a modern template engine for JavaScript. Full documentation for Moe-js is . This post explains the rationale behind it. available here Background The original motivation for Moe-js came during a re-write of my own website .  The site is mostly static content driven by a set of plain text files - basically Markdown files with a bit of YAML "front matter" at the top defining additional data associated with that page. http://www.toptensoftware.com In this case I'm really using Express' view engine as a theming engine and being able to include a reasonable sprinkling of logic in the view meant I could completely eliminate that middle "business logic" layer. The other thing I needed was the ability for a template to load the meta-data for referenced pages. eg: loading a referenced page to pull out its title, a synopsis summary or the URL of its banner image.  As we all know, doing this synchronously is bad form in Node so I wanted a template engine that could render templates asynchronously. Design Goals Bringing all this together I came up with the following design goals: Handlebars like syntax Embedded JavaScript support Compiled and fast Async enabled Easy extensibility model Handlebars Like Syntax Despite my gripes with Handlebars I really like the syntax - it's easy to understand, easy to learn, easy to type and clearly distinguishes template script from markup. Also, I had a lot of projects using Handlebars so I wanted a syntax that would be easy to convert to the new template engine. If you're familiar with Handlebars, Moe-js will seem very familiar: {{model.title}} {{#each item in model.items}}
    {{#if item.price != 0}} {{item.name.toUpperCase()}} - {{{helpers.formatPrice(item.price)}}} {{/if}}
{{/each}} < > h1 </ > h1 < > p </ > p Embedded JavaScript Support Moe-js supports JavaScript expressions.  In the above example, note the following: Calling a JavaScript member: item.name.toUpperCase() JavaScript conditions: item.price != 0 Helper functions: helpers.formatPrice(...) You can also embed entire code blocks with the code directive: {{#code}}
function doSomething(value)
{
    ...
}
{{/code}}

{{doSomething(99)}} Compiled and Fast For simplicity and performance, Moe-js compiles templates to straight JavaScript. In order to avoid dynamic lookups at runtime, Moe-js requires all data properties be explicitly referenced.  To explain, in Handlebars, you can reference a data property just by name: {{title}} < > p </ > p Because of the embedded JavaScript support, this won't work in Moe-js. Without completely parsing and understanding the expression and without knowing the properties of the data object eventually passed to the template, there's no way to know where that "title" property comes from.  It could be a property on the passed data object, a local variable, a scope variable etc... For this reason, data properties must be explicitly referenced via the special model property: {{model.title}} < > p </ > p Similarly, in loop iterators, a variable is used to explicitly specify which loop variable to use: {{#each u in model.Users}}
{{#each r in u.roles}} Name: {{u.name}} Role: {{r}} {{/each}}
{{/each}} < > p </ > p While this makes conversion of templates from Handlebars to Moe-js more tedious than I'd like, in the end it makes the compilation simpler, rendering faster and I've come to prefer this more explicit style. Async Enabled Moe-js templates can be compiled to execute either synchronously or asynchronously.  An asynchronously compiled template can use the JavaScript await keyword: Data: {{await model.callSomeAsyncMethod()}} < > p </ > p If you're using Moe-js' Express integration, async support is automatically enabled. Easy Extensibility Moe-js provides extensibility via the property.  Say you wanted a helper function to format prices.  Add the helper like so: moe.helpers moe.helpers.FormatPrice = { (val == ) ; + val.toFixed( );
} ( ) function val if 0 return "-" else return "$" 2 And then call it in your template: Price: {{helpers.FormatPrice(item.price)}} < > p </ > p Other Features Moe-js has the typical template engine features, including: Support for Partials and Layouts Express View Engine Integration Redirecting Template Output to a variable Compiled Template Caching No Dependencies Check It Out Because of its embedded JavaScript support, Moe-js shouldn't be used for template scripts from untrusted sources.  ie: you shouldn't let users of your site upload templates for execution on your server. However, if you're after a simple, easy to use, modern, async enabled view engine for your next Node/Express project it might be a good option and I encourage you to and what you think. give it a go let me know InheritDoc.io With each post I like to share someone else's project and recently I came across by FireShark Studios. InheritDoc.io If you're writing C# XML documentation, you may be familiar with the directive that is used by some documentation generators to inherit the documentation from a base class. <inheritdoc /> The trouble with this approach is those inherited declarations aren't available in the Visual Studio Intellisense.  FireShark's project resolves this by rewriting the original .XML documentation files, replacing the directive with the actual inherited documentation. <inheritdoc /> What's more its been extended to allow pulling documentation from other methods and there's a nice site explaining how it all works. Check it out here: https://www.inheritdoc.io

Flow

Rendering Markdown Pages with Express and Los Angeles

Read My Stories

Too Long; Didn't Read

Make resilience your competitive advantage

Moe-js - A Modern Template Engine for JavaScript

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

...So I Ended up Making DocBrowser - An HTML Template for Documentation

100 Stories To Learn About Html5

10 Frontend Projects to Take Your Coding Skills to the Next Level

10 CSS Tips To Make Your Site Faster

10 Cool Data Table Libraries with Advanced Features

...So I Ended up Making DocBrowser - An HTML Template for Documentation

100 Stories To Learn About Html5

10 Frontend Projects to Take Your Coding Skills to the Next Level

10 CSS Tips To Make Your Site Faster

10 Cool Data Table Libraries with Advanced Features

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps