Events

UJML provides events for user interaction, resources, and sounds.

The event element provides a way to declare event handlers for events by name. See Handling Events, event. Besides events provided by UJML extensions, UJML provides a set of built-in events for various purposes. These built-in events cover a wide range of purposes, including user interaction, resources, and sounds.

Depending on the purpose of the event it may be used in different ways and/or may only be contained by certain elements. In most cases, events are contained by a visual element of some kind and there may only be one event per visual element. See Visual Elements. Events may also be contained by a resource element. See Resources, resource. The following table lists the events by purpose:

Event Purpose	Events	Contained by
Select a visual element	onSelect	A visual element
Capture button presses and releases	onKeyDown, onKeyUp	A visual element
Capture when a sound starts or finishes playing	onSoundStarted, onSoundFinished	A visual element
Capture network activity for a resource	onRequestFailed, onRequestStarted, onRequestSucceeded	A visual element
Capture resource availability	onResourceAvailable, onResourceError	A resource element

The UNLOAD event

One event distinct from the above list is the UNLOAD event; a special case of the onSelect event which fires when the application unloads. See UNLOAD Event.

Topics

Topic	Description
onKeyDown Event	This is an event which occurs when a user presses any key on the device.
onKeyUp Event	This is an event which occurs when a user presses and releases any key on the device.
onSelect Event	An event which occurs when a user selects a visual element or clicks a key associated with the event element.
onSoundStarted Event	This is an event which occurs when a sound starts playing.
onSoundFinished Event	This is an event which occurs when a sound finishes playing.
onRequestStarted Event	This is an event which occurs when a network request starts.
onRequestSucceeded Event	This is an event which occurs when a network request finishes successfully.
onRequestFailed Event	This is an event which occurs when a network request fails.
onResourceAvailable Event	This is an event which occurs when a resource is successfully loaded into memory.
onResourceError Event	This is an event which occurs when a resource fails to load into memory.