Binding Element Attributes Edit Page


In addition to normal text, you may also want to have your templates contain HTML elements whose attributes are bound to the controller.

For example, imagine your controller has a property that contains a URL to an image:

<div id="logo">
  <img src={{logoUrl}} alt="Logo">
</div>

This generates the following HTML:

<div id="logo">
  <img src="http://www.example.com/images/logo.png" alt="Logo">
</div>

If you use data binding with a Boolean value, it will add or remove the specified attribute. For example, given this template:

<input type="checkbox" disabled={{isAdministrator}}>

If isAdministrator is true, Handlebars will produce the following HTML element:

<input type="checkbox" disabled>

If isAdministrator is false, Handlebars will produce the following:

<input type="checkbox">

Adding Other Attributes (Including Data Attributes)

By default, helpers and components only accept a limited number of HTML attributes. This means that some uncommon but perfectly valid attributes, such as lang or custom data-* attributes must be specifically enabled. For example, this template:

{{#link-to "photos" data-toggle="dropdown" lang="es"}}Fotos{{/link-to}}

{{input type="text" data-toggle="tooltip" data-placement="bottom" title="Name"}}

renders the following HTML:

<a id="ember239" class="ember-view" href="#/photos">Fotos</a>

<input id="ember257" class="ember-view ember-text-field" type="text"
       title="Name">

To enable support for these attributes an attribute binding must be added to the component, e.g. Ember.LinkComponent or Ember.TextField for the specific attribute:

Ember.LinkComponent.reopen({
  attributeBindings: ['data-toggle', 'lang']
});

Ember.TextField.reopen({
  attributeBindings: ['data-toggle', 'data-placement']
});

Now the same template above renders the following HTML:

<a id="ember240" class="ember-view" href="#/photos" data-toggle="dropdown" lang="es">Fotos</a>

<input id="ember259" class="ember-view ember-text-field"
       type="text" data-toggle="tooltip" data-placement="bottom" title="Name">