Old Guides - You are viewing the guides for Ember v1.12.0. VIEW v3.28.0
Edit Page

Handlebars Basics

Ember.js uses the Handlebars templating library to power your app's user interface. Handlebars templates are just like regular HTML, but also give you the ability to embed expressions that change what is displayed.

We take Handlebars and extend it with many powerful features. It may help to think of your Handlebars templates as an HTML-like DSL for describing the user interface of your app. And, once you've told Ember.js to render a given template on the screen, you don't need to write any additional code to make sure it keeps up-to-date.

Defining Templates

By default, adjust your application template, that is created automatically for you and will be displayed on the page when your app loads.

You can also define templates by name that can be used later. If you would like to create a template that is shared across many areas of your site, you should investigate components. The components section contains information on creating re-usable templates.

Handlebars Expressions

Each template has an associated controller: this is where the template finds the properties that it displays.

You can display a property from your controller by wrapping the property name in curly braces, like this:

Hello, <strong>{{firstName}} {{lastName}}</strong>!

This would look up the firstName and lastName properties from the controller, insert them into the HTML described in the template, then put them into the DOM.

By default, your top-most application template is bound to your application controller. Note that this file is not shown by default because it is created behind the scenes by Ember CLI. To customize the controller, create the following file:

export default Ember.Controller.extend({
  firstName: "Trek",
  lastName: "Glowacki"

The above template and controller would combine to display the following rendered HTML:

Hello, <strong>Trek Glowacki</strong>!

These expressions (and the other Handlebars features you will learn about next) are bindings aware. That means that if the values used by your templates ever change, your HTML will be updated automatically.

As your application grows in size, it will have many templates, each bound to different controllers.