StructureJS
0.15.2A class based utility library for building modular and scalable web platform applications. Features opt-in classes and utilities which provide a solid foundation and toolset to build your next project.
The BaseEvent class is used as the base class for the creation of Event objects, which are passed as parameters to event listeners when an event occurs.
The properties of the BaseEvent class carry basic information about an event, such as the event's type or whether the event's default behavior can be canceled.
For many events, such as the events represented by the Event class constants, this basic information is sufficient. Other events, however, may require more detailed information.
bubbles
Boolean
public
Indicates whether an event is a bubbling event.
Default: false
cancelable
Boolean
public
Indicates whether the behavior associated with the event can be prevented.
Default: false
currentTarget
Any
public
The currentTarget property always points to the DisplayObjectContainer that the event is currently processing (i.e. bubbling at).
Default: null
data
Any
public
Used to pass any type of data with the event.
Default: null
isImmediatePropagationStopped
Boolean
public
Indicates if the stopImmediatePropagation was called on the event object.
Default: false
isPropagationStopped
Boolean
public
Indicates if the stopPropagation was called on the event object.
Default: false
sjsId
Int
public
The sjsId (StructureJS ID) is a unique identifier automatically assigned to most StructureJS objects upon instantiation.
Default: null
target
Any
public
A reference to the object that originally dispatched the event.
Default: null
type
String
public
The type of event.
Default: null
BaseEvent
type
[bubbles=false]
[cancelable=false]
[data=null]
type
String
The type of event. The type is case-sensitive.
[bubbles=false]
Boolean
optional
Indicates whether an event is a bubbling event. If the event can bubble, this value is true; otherwise it is false. Note: With event-bubbling you can let one Event subsequently call on every ancestor (parent) (containers of containers of etc.) of the DisplayObjectContainer that originally dispatched the Event, all the way up to the surface (Stage). Any classes that do not have a parent cannot bubble.
[cancelable=false]
Boolean
optional
Indicates whether the behavior associated with the event can be prevented. If the behavior can be canceled, this value is true; otherwise it is false.
[data=null]
Any
optional
Use to pass any type of data with the event.
// Example: how to create a custom event by extending BaseEvent.
class CountryEvent extends BaseEvent {
CHANGE_COUNTRY = 'CountryEvent.changeCountry';
constructor(type, bubbles = false, cancelable = false, data = null) {
super(type, bubbles, cancelable, data);
this.countryName = null;
}
}
// Example: how to use the custom event.
let event = new CountryEvent(CountryEvent.CHANGE_COUNTRY);
event.countryName = 'Canada';
this.dispatchEvent(event);
clone
()
BaseEvent
public
Duplicates an instance of an BaseEvent subclass.
Returns a new BaseEvent object that is a copy of the original instance of the BaseEvent object.
The new BaseEvent object includes all the properties of the original.
let cloneOfEvent = event.clone();
destroy
()
Void
public
The purpose of the destroy method is to make an object ready for garbage collection. This should be thought of as a one way function. Once destroy is called no further methods should be called on the object or properties accessed. It is the responsibility of those who implement this function to stop all running Timers, all running Sounds, and take any other steps necessary to make an object eligible for garbage collection.
By default the destroy method will null out all properties of the class automatically. You should call destroy on other objects before calling the super.
destroy() {
this.disable();
this._childInstance.destroy();
super.destroy();
}
getQualifiedClassName
()
String
public
Returns the fully qualified class name of an object.
Returns the class name.
let someClass = new SomeClass();
someClass.getQualifiedClassName();
// SomeClass
stopImmediatePropagation
()
public
Prevents processing of any event listeners in the current node and any subsequent nodes in the event flow. This method takes effect immediately, and it affects event listeners in the current node. In contrast, the stopPropagation method doesn't take effect until all the event listeners in the current node finish processing.
event.stopImmediatePropagation();
stopPropagation
()
public
Prevents processing of any event listeners in nodes subsequent to the current node in the event flow. This method does not affect any event listeners in the current node (currentTarget). In contrast, the stopImmediatePropagation method prevents processing of event listeners in both the current node and subsequent nodes. Additional calls to this method have no effect.
event.stopPropagation();
ACTIVATE
The BaseEvent.ACTIVATE constant defines the value of the type property of an activate event object.
ADDED
The BaseEvent.ADDED constant defines the value of the type property of an added event object.
ADDED_TO_STAGE
The BaseEvent.ADDED_TO_STAGE constant defines the value of the type property of an addedToStage event object.
CANCEL
The BaseEvent.CANCEL constant defines the value of the type property of a cancel event object.
CHANGE
The BaseEvent.CHANGE constant defines the value of the type property of a change event object.
CLEAR
The BaseEvent.CLEAR constant defines the value of the type property of a clear event object.
CLOSE
The BaseEvent.CLOSE constant defines the value of the type property of a close event object.
CLOSING
The BaseEvent.CLOSING constant defines the value of the type property of a closing event object.
COMPLETE
The BaseEvent.COMPLETE constant defines the value of the type property of a complete event object.
CONNECT
The BaseEvent.CONNECT constant defines the value of the type property of a connect event object.
DEACTIVATE
The BaseEvent.DEACTIVATE constant defines the value of the type property of a deactivate event object.
DISPLAYING
The BaseEvent.DISPLAYING constant defines the value of the type property of a displaying event object.
ENTER_FRAME
The BaseEvent.ENTER_FRAME constant defines the value of the type property of an enterFrame event object.
EXIT_FRAME
The BaseEvent.EXIT_FRAME constant defines the value of the type property of an exitFrame event object.
EXITING
The BaseEvent.EXITING constant defines the value of the type property of an exiting event object.
FULLSCREEN
The BaseEvent.FULL_SCREEN constant defines the value of the type property of a fullScreen event object.
INIT
The BaseEvent.INIT constant defines the value of the type property of an init event object.
NETWORK_CHANGE
The BaseEvent.NETWORK_CHANGE constant defines the value of the type property of a networkChange event object.
OPEN
The BaseEvent.OPEN constant defines the value of the type property of an open event object.
PASTE
The BaseEvent.PASTE constant defines the value of the type property of a paste event object.
PREPARING
The BaseEvent.PREPARING constant defines the value of the type property of a preparing event object.
REMOVED
The BaseEvent.REMOVED constant defines the value of the type property of a removed event object.
RENDER
The BaseEvent.RENDER constant defines the value of the type property of a render event object.
RESIZE
The BaseEvent.RESIZE constant defines the value of the type property of a resize event object.
SELECTED
The BaseEvent.SELECTED constant defines the value of the type property of a selected event object.