Handlebars partial vs. render vs. template

ember.js handlebars.js mustache
Marius Butuc picture Marius Butuc · Feb 4, 2013 · Viewed 17.5k times · Source

The Fire Up Ember.js screencast uses partial, template, render to render templates within templates, but I'm still not sure I know which one to use when.

In the same screencast the partial is explained as using the context and all data relative to the current controller, while render uses the the specified controller's matching template, context etc:

Fire Up Ember.js: partial versus Fire Up Ember.js

Can someone please clarify the differences between partial, template, render and when (examples) to use which?

Answer

Andre Malan picture Andre Malan · Feb 5, 2013

The way I understand it, the way they break down is like this:

"render" gives you an entire view/controller/template context of its own to work with.

An example will be a top navigation that includes dynamic pieces. The content will be maintained within a TopNavController and inserted into the application template using "render"

"partial" will insert a template, but that template will be using the current context instead of its own. Partial is also a newer part of the framework, meant to replace using template to some extent.

An example would be showing a list of users and having each user be a relatively complicated piece in the list (avatar, name, email, etc) you can just loop through the list and insert the partial based in the context of each user.

"template" just inserts the template using the current context. I believe it's not good style though to use template to render pieces inside of a template, you should rather use "partial" although template will work the same way for most cases.

Related questions

How to implement not with if statement in Ember Handlebars?

I have a statement like this: {{#if IsValid}} I want to know how I can use a negative if statement that would look like that: {{#if not IsValid}}

Read More
Check for a value equals to in Ember Handlebar If block helper

How do we check for a value equality in ember.js's If-block helper? {{#if person=="John"}} How do we perform above in handlebars?

Read More
SetTimeout vs. Ember.run.later in an ember app?

Inside my handlebars template: Today's date: {{currentDate}} Current Time: {{currentTime}} Inside my helpers: Ember.Handlebars.registerBoundHelper 'currentDate', (option) -> moment().format('LL'); Ember.Handlebars.registerBoundHelper 'currentTime', (option) -> moment().format('h:mm:ss a'); How would I go …

Read More