attachDOMEvent

Summary

Attach user-defined event handler for any DOM event for an element.

Syntax

keyman.util.attachDOMEvent(Pelem, eventName, handler, useCapture);

Parameters

Pelem

Type: Element

Element to which the event is being attached.

eventName

Type: string

The name of the event, without an 'on' prefix.

handler

Type: function(Object)

The event handler being attached.

useCapture

Type: boolean optional

Set this to true if the event should be captured in the bubbling phase; otherwise, use false or leave this parameter empty.

Return Value

undefined

Description

The event name should be specified without the 'on' prefix. The fourth argument, useCapture, is optional and will default to false.

The method exists for legacy reasons that arise when dealing with old versions of IE, simplifying event-handling code.

See also: keyman.util.detachDOMEvent