Using Block Params

{{blog-post post=model}}

{{yield post.title post.body post.author}}

Here an entire blog post model is being passed to the component as a single component property. In turn the component is returning values using yield. In this case the yielded values are pulled from the post being passed in but anything that the component has access to can be yielded, such as an internal property or something from a service.

The block expression can then use block params to bind names to any yielded values for use in the block. This allows for template customization when using a component, where the markup is provided by the consuming template, but any event handling behavior implemented in the component is retained such as click() handlers.

{{#blog-post post=model as |title body author|}}
  <h2>{{title}}</h2>
  <p class="author">by {{author}}</p>
  <p class="post-body">{{body}}</p>
{{/blog-post}}

The names are bound in the order that they are passed to yield in the component template.

It is possible to support both block and non-block usage of a component from a single component template using the has-block helper.

{{#if (has-block)}}
  {{yield post.title post.body post.author}}  
{{else}}
  <h1>{{post.title}}</h1>
  <p class="author">Authored by {{post.author}}</p>
  <p>{{post.body}}</p>
{{/if}}

This has the effect of providing a default template when using a component in the non-block form but providing yielded values for use with block params when using a block expression.