Moobile.EventFirer

Moobile.EventFirer

800 450 ThomasEngels
Implements Events, Options, Class.Binds

Provides the base class for classes that fire events.

Methods

fireEvent(type, [args], [delay])

Fires all events of a specified type if this type allowed to fire. This method appends a reference of the object that fires the event to the argument list.

Parameters:

Name Type Description
type String The type of event (e.g. ‘complete’).
args Optional Array The argument(s) to pass to the function. To pass more than one argument, the arguments must be in an array.
delay Optional Number Delay in milliseconds to wait before executing the event (defaults to 0).

Returns:

  • Moobile.EventFirer This Class instance.

Example:

var Cow = new Class({
    Extends: Moobile.EventFirer,
    eat: function() {
        this.fireEvent('ingest', 'hay']);
    }
});
var daisy = new Cow();
daisy.addEvent('ingest', function(food, sender) {
    console.log(food); // 'hay'
    console.log(sender); // the 'daisy' instance
});
daisy.eat();

eventShouldFire(type, args)

Indicates whether the specified event can be fired.

Override this method if you wish to limit the events that can be fired.

Parameters:

Name Type Description
type String The event’s type.
args Array The event’s arguments.

Returns:

  • Boolean Whether the event can be fired.

Example:

var Cow = new Class({
    Extends: Moobile.EventFirer,
    eat: function() {
        this.fireEvent('ingest', 'hay']);
        this.fireEvent('ingest', 'mud']);
    },
    eventShouldFire: function(type, args) {
        if (type == 'ingest') {
            return args[0] === 'hay';
        }
        return this.parent(type, args);
    }
});
var daisy = new Cow();
daisy.addEvent('ingest', function(food, sender) {
    // this will be called only once because the second event will not fire
    console.log(food); // 'hay'
    console.log(sender); // the 'daisy' instance
});
daisy.eat();

willFireEvent(type, args)

Tell this entity it’s about to fire an event.

Override this method to provide your own implementation.

Parameters:

Name Type Description
type String The event’s type.
args Array The event’s arguments.

Example:

var Cow = new Class({
    Extends: Moobile.EventFirer,
    eat: function() {
        this.fireEvent('ingest', 'hay']);
    },
    drink: function() {
        // ...
    },
    willFireEvent: function(type, args) {
        if (type == 'ingest') {
            // this will always be called before the event ingest is fired
            this.drink();
        }
    }
});
var daisy = new Cow();
daisy.eat();

didFireEvent(type)

Tell this entity it fired an event.

Override this method to provide your own implementation.

Parameters:

Name Type Description
type String The event’s type.
args Array The event’s arguments.

Example:

var Cow = new Class({
    Extends: Moobile.EventFirer,
    eat: function() {
        this.fireEvent('ingest', 'hay']);
    },
    cleanup: function() {
        // ...
    },
    didFireEvent: function(type, args) {
        if (type == 'ingest') {
            // this will always be called after the event ingest is fired
            this.cleanup();
        }
    }
});
var daisy = new Cow();
daisy.eat();