W3cubDocs

/DOM

UIEvent

The UIEvent interface represents simple user interface events.

UIEvent derives from Event. Although the UIEvent.initUIEvent() method is kept for backward compatibility, you should create a UIEvent object using the UIEvent() constructor.

Several interfaces are direct or indirect descendants of this one: MouseEvent, TouchEvent, FocusEvent, KeyboardEvent, WheelEvent, InputEvent, and CompositionEvent.

Constructors

UIEvent()
Creates a UIEvent object.

Properties

This interface also inherits properties of its parent, Event.

UIEvent.cancelBubble
Is a Boolean indicating whether the bubbling of the event has been canceled or not.
UIEvent.detailRead only
Returns a long with details about the event, depending on the event type.
UIEvent.isChar Read only
Returns a Boolean indicating whether the event produced a key character or not.
UIEvent.layerX Read only
Returns the horizontal coordinate of the event relative to the current layer.
UIEvent.layerY Read only
Returns the vertical coordinate of the event relative to the current layer.
UIEvent.pageX Read only
Returns the horizontal coordinate of the event relative to the whole document.
UIEvent.pageY Read only
Returns the vertical coordinate of the event relative to the whole document.
UIEvent.sourceCapabilities Read only
Returns an instance of the InputDeviceCapabilities interface which provides information about the physical device responsible for generating a touch event.
UIEvent.viewRead only
Returns a WindowProxy that contains the view that generated the event.
UIEvent.which Read only
Returns the numeric keyCode of the key pressed, or the character code (charCode) for an alphanumeric key pressed.

Methods

This interface also inherits methods of its parent, Event.

UIEvent.initUIEvent()
Initializes a UIEvent object. If the event has already being dispatched, this method does nothing.

Specifications

Specification Status Comment
InputDeviceCapabilities Draft Added sourceCapabilities property.
UI Events Working Draft Extend DOM3
Document Object Model (DOM) Level 3 Events Specification
The definition of 'UIEvent' in that specification.
Obsolete Added the UIEvent() constructor, deprecated the initUIEvent() method and changed the type of view from AbstractView to WindowProxy.
Document Object Model (DOM) Level 2 Events Specification
The definition of 'UIEvent' in that specification.
Obsolete Initial definition

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support Yes Yes Yes ? Yes ?
UIEvent() constructor Yes Yes 11 ? Yes ?
cancelBubble Yes Yes Yes Yes Yes Yes
detail Yes Yes Yes 9 Yes Yes
initUIEvent Yes Yes Yes ? Yes ?
isChar No No ? — 55
? — 55
The isChar property has never been supported by any browser but Firefox, and even on Firefox it's never worked except on Mac OSX. For that reason, it's been removed in Firefox 55 to align with other browsers.
No No No
layerX Yes Yes Yes 9 Yes Yes
layerY Yes Yes Yes 9 Yes Yes
pageX ? — 44
? — 44
Replaced by MouseEvent.pageX in version 45.
? ? 9 ? ?
pageY ? — 44
? — 44
Replaced by MouseEvent.pageY in version 45.
? ? 9 ? ?
sourceCapabilities 47 ? ? ? ? ?
view Yes Yes Yes 9 Yes Yes
which ? ? ? ? ? ?
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support Yes Yes Yes Yes Yes ? ?
UIEvent() constructor Yes Yes Yes 14 Yes ? ?
cancelBubble Yes Yes Yes Yes Yes Yes ?
detail Yes Yes Yes Yes Yes Yes ?
initUIEvent Yes Yes Yes Yes Yes ? ?
isChar No No No ? — 55
? — 55
The isChar property has never been supported by any browser but Firefox, and even on Firefox it's never worked except on Mac OSX. For that reason, it's been removed in Firefox 55 to align with other browsers.
No No No
layerX Yes Yes Yes Yes Yes Yes ?
layerY Yes Yes Yes Yes Yes Yes ?
pageX ? — 44
? — 44
Replaced by MouseEvent.pageX in version 45.
? — 44
? — 44
Replaced by MouseEvent.pageX in version 45.
? ? ? ? ?
pageY ? — 44
? — 44
Replaced by MouseEvent.pageY in version 45.
? — 44
? — 44
Replaced by MouseEvent.pageY in version 45.
? ? ? ? ?
sourceCapabilities 47 47 ? ? ? ? ?
view Yes Yes Yes Yes Yes Yes ?
which ? ? ? ? ? ? ?

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/UIEvent