Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A variant of Handlebars that emits DOM and allows you to write helpers that manipulate live DOM nodes
JavaScript HTML

Change blocks to an object

This makes the structure of internal Blocks clear, which makes it easier
to avoid accidental performance regressions.
latest commit 40b64397fe
@chancancode chancancode authored

Status Build Status Sauce Test Status

HTMLBars is a layer built on top of the Handlebars template compiler.


The goal of HTMLBars is to have a compiler for Handlebars that builds a DOM rather than a String.

This means that helpers can have special behavior based on their context (they know if they are inside an <a> tag, inside an attribute, etc.)

Ultimately, the goal is to have a good data binding setup for Handlebars that can work directly against DOM nodes and doesn't need special tags in the String for the data binding code to work (a major limitation in Ember).

There are also many performance gains in HTMLBars' approach to building DOM vs the HTML-unaware string building approach of Handlebars.


TODO: much change. This section will be updated shortly.

Until then, check out for info on how HTMLBars is structured and its approach to efficiently building / emitting DOM.

Building HTMLBars

  1. Ensure that Node.js is installed.
  2. Run npm install to ensure the required dependencies are installed.
  3. Run npm run-script build to build HTMLBars. The builds will be placed in the dist/ directory.

How to Run Tests

Via Ember CLI

  1. Run: ember test --server

Ember CLI is a CI tool, so it will run tests as you change files.

On the console with PhantomJS

  1. Run npm test.

In a browser

  1. Run npm start.
  2. Visit http://localhost:4200/tests/.
Something went wrong with that request. Please try again.