W3cubDocs

/Ember.js

Ember.ActionSupport Class

PRIVATE

Defined in: packages/ember-views/lib/mixins/action_support.js:21

Module: ember-views

sendAction (action, params) public

Defined in packages/ember-views/lib/mixins/action_support.js:27

Calls an action passed to a component.

For example a component for playing or pausing music may translate click events into action notifications of "play" or "stop" depending on some internal state of the component:

// app/components/play-button.js
export default Ember.Component.extend({
  click() {
    if (this.get('isPlaying')) {
      this.sendAction('play');
    } else {
      this.sendAction('stop');
    }
  }
});

The actions "play" and "stop" must be passed to this play-button component:

{{! app/templates/application.hbs }}
{{play-button play=(action "musicStarted") stop=(action "musicStopped")}}

When the component receives a browser click event it translate this interaction into application-specific semantics ("play" or "stop") and calls the specified action.

// app/controller/application.js
export default Ember.Controller.extend({
  actions: {
    musicStarted() {
      // called when the play button is clicked
      // and the music started playing
    },
    musicStopped() {
      // called when the play button is clicked
      // and the music stopped playing
    }
  }
});

If no action is passed to sendAction a default name of "action" is assumed.

// app/components/next-button.js
export default Ember.Component.extend({
  click() {
    this.sendAction();
  }
});
{{! app/templates/application.hbs }}
{{next-button action=(action "playNextSongInAlbum")}}
// app/controllers/application.js
App.ApplicationController = Ember.Controller.extend({
  actions: {
    playNextSongInAlbum() {
      ...
    }
  }
});

Parameters:

action [String]
the action to call
params [*]
arguments for the action

© 2017 Yehuda Katz, Tom Dale and Ember.js contributors
Licensed under the MIT License.
http://emberjs.com/api/classes/Ember.ActionSupport.html