compositionupdate Redirect 1

The compositionupdate event is fired when a character is added to a passage of text being composed (fires with special characters that require a sequence of keys and other inputs such as speech recognition or word suggestion on mobile).

General info

Specification
DOM L3
Interface
TouchEvent
Bubbles
Yes
Cancelable
Yes
Target
Element
Default Action
None

Properties

Property Type Description
target Read only EventTarget Focused element processing the composition, null if not accessible.
type Read only DOMString The type of event.
bubbles Read only boolean Does the event normally bubble?
cancelable Read only boolean Is it possible to cancel the event?
view Read only WindowProxy document.defaultView (the window of the document).
detail Read only long (float) 0.
data DOMString (string) The original string being edited, otherwise the empty string. Read only.
locale DOMString (string) The language code for the composition event, if available; otherwise, the empty string. Read only.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support

(Yes)

Not dispatched immediately after compositionstart event.

9.0 (9.0) (Yes) Not supported ?
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? 9.0 (9.0) ? ? ?

Gecko notes

compositionupdate events are fired before editor contents are actually changed; that is, the value of an editable element has not yet been changed when compositionupdate event handlers are called. Starting in Gecko 12.0 (Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9), input events are fired while editing is underway, after the contents of the element are changed. This lets you get the updated contents while editing is underway.

Note: Gecko doesn't support the locale attribute for trusted events yet.  However, web developers can set this value via initCompositionEvent() when creating untrusted events.

Document Tags and Contributors

Contributors to this page: ethertank
Last updated by: ethertank,