« All deprecation guides

Deprecation Guide for Block and multi-argument unbound helper

The unbound helper is mostly a legacy API in Ember, although it is not being removed in 2.0. It was almost exclusively used to manage performance issues which are well addressed in Ember 1.13's new rendering engine.

The first form being deprecated is the block form of unbound. For example:

{{#unbound if someState}}
  Show this
{{/unbound}}

Instead, replace this form with a nested helper:

{{#if (unbound someState)}}
  Show this
{{/if}}

The second form being deprecated is the non-nested helper lookup. For example:

{{unbound some-custom-helper withArg anotherArg}}

Replace this form with nested helper call:

{{unbound (some-custom-helper withArg anotherArg)}}

Or make all inputs to the helper unbound:

{{some-custom-helper (unbound withArg) (unbound anotherArg)}}