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

Rendering a Template

One job of a route handler is rendering the appropriate template to the screen.

By default, a route handler will render the template with the same name as the route. Take this router:

Router.map(function() {
  this.route('posts', function() {

Here, the posts route will render the posts.hbs template, and the posts.new route will render posts/new.hbs.

Each template will be rendered into the {{outlet}} of its parent route's template. For example, the posts.new route will render its template into the posts.hbs's {{outlet}}, and the posts route will render its template into the application.hbs's {{outlet}}.

If you want to render a template other than the default one, set the route's templateName property to the name of the template you want to render instead.

import Route from '@ember/routing/route';

export default class PostsRoute extends Route {
  templateName = 'posts/favorite-posts';

You can override the renderTemplate() hook if you want finer control over template rendering. Among other things, it allows you to choose the controller used to configure the template and specific outlet to render it into.