Class: Phaser.SignalBinding
Constructor
new SignalBinding(signal, listener, isOnce, listenerContext, priority, args)
Object that represents a binding between a Signal and a listener function.
This is an internal constructor and shouldn't be created directly.
Inspired by Joa Ebert AS3 SignalBinding and Robert Penner's Slot classes.
Parameters
Name | Type | Argument | Default | Description |
---|---|---|---|---|
signal | Phaser.Signal | Reference to Signal object that listener is currently bound to. | ||
listener | function | Handler function bound to the signal. | ||
isOnce | boolean | If binding should be executed just once. | ||
listenerContext | object | <optional> | null | Context on which listener will be executed (object that should represent the |
priority | number | <optional> | The priority level of the event listener. (default = 0). | |
args | any | <optional> <repeatable> | (none) | Additional arguments to pass to the callback (listener) function. They will be appended after any arguments usually dispatched. |
- Source code: core/SignalBinding.js (Line 22)
Public Properties
- Default Value
- true
- Source code: core/SignalBinding.js (Line 93)
- Source code: core/SignalBinding.js (Line 86)
- Source code: core/SignalBinding.js (Line 63)
- array | null
- Source code: core/SignalBinding.js (Line 100)
active : boolean
If binding is active and should be executed.
callCount : number
The number of times the handler function has been called.
context : Object
Context on which listener will be executed (object that should represent the this
variable inside listener function).
params :array | null
Default parameters passed to listener during Signal.dispatch
and SignalBinding.execute
(curried parameters).
Type
Public Methods
- Source code: core/SignalBinding.js (Line 136)
- Source code: core/SignalBinding.js (Line 102)
- Source code: core/SignalBinding.js (Line 162)
- Source code: core/SignalBinding.js (Line 170)
- Source code: core/SignalBinding.js (Line 146)
- Source code: core/SignalBinding.js (Line 154)
- Source code: core/SignalBinding.js (Line 189)
detach() → {function | null}
Detach binding from signal.
alias to: @see mySignal.remove(myBinding.getListener());
Returns
Handler function bound to the signal or null
if binding was previously detached.
execute(paramsArr) → {any}
Call listener passing arbitrary parameters.
If binding was added using Signal.addOnce()
it will be automatically removed from signal dispatch queue, this method is used internally for the signal dispatch.
Parameters
Name | Type | Argument | Description |
---|---|---|---|
paramsArr | Array.<any> | <optional> | Array of parameters that should be passed to the listener. |
Returns
Value returned by the listener.
getListener() → {function}
Returns
Handler function bound to the signal.
getSignal() → {Phaser.Signal}
Returns
Signal that listener is currently bound to.
isBound() → {boolean}
Returns
True if binding is still bound to the signal and has a listener.
isOnce() → {boolean}
Returns
If SignalBinding will only be executed once.
toString() → {string}
Returns
String representation of the object.
© 2016 Richard Davey, Photon Storm Ltd.
Licensed under the MIT License.
http://phaser.io/docs/2.6.2/Phaser.SignalBinding.html