WARNING
You probably don't need to use this addon. Most of the use cases you'd use this addon for are perfectly achievable without this addon. Read the following blog post for more info: Ember Best Practices: What are controllers good for?
ember-route-action-helper
Credit: @rwjblue's jsbin
Demo: http://jsbin.com/jipani/edit?html,js,output
ember install ember-route-action-helper
The route-action
helper allows you to bubble closure actions, which will delegate it to the currently active route hierarchy per the bubbling rules explained under actions
. Like closure actions, route-action
will also have a return value.
However, returning true
in an action will not preserve bubbling semantics. In case you would like that behavior, you should use ordinary string actions instead.
Usage
For example, this route template tells the component to lookup the updateFoo
action on the route when its internal clicked
property is invoked, and curries the function call with 2 arguments.
{{! foo/route.hbs }}{{foo-bar clicked=(route-action "updateFoo" "Hello" "world")}}
If the action is not found on the current route, it is bubbled up:
// application/route.js; const Route set = Ember; ;
If no action is found after bubbling, an error will be raised. The route-action
also has a return value:
// foo/component.js; const Component = Ember; ;
You may also use in conjunction with the {{action}}
helper:
<button >Update Foo</button>
Compatibility
This addon will work on Ember versions 1.13.x
and up only, due to use of the new Helper
implementation.
Installation
git clone
this repositorynpm install
bower install
Running
ember server
- Visit your app at http://localhost:4200.
Running Tests
npm test
(Runsember try:testall
to test your addon against multiple Ember versions)ember test
ember test --server
Overriding route-action for integration tests
This helper is designed for use in controller templates, not in components. It will not, therefore, resolve route action references in an integration test. If you are using this helper in your components, you can override the helper using a pattern similar to the following:
;;; ;
Building
ember build
For more information on using ember-cli, visit http://www.ember-cli.com/.
Legal
DockYard, Inc © 2015