spiegel-keyman/web/docs/engine/reference/util/attachDOMEvent.md
Marc Durdin 1f82507730 docs(web): deprecate unused and obsolete API endpoints and docs cleanup
Deprecate the following obsolete functions and properties:
* `keyman.helpURL`
* `keyman.util.rgba`
* `keyman.util.toFloat`
* `keyman.util.toNumber`
* `keyman.util.toNzString`

Use correct language for code blocks in Keyman Engine for Web
documentation.

Test-bot: skip
2026-08-12 16:07:22 +02:00

991 B

title
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