compositionupdate

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).

Bubbles	Yes
Cancelable	No
Target objects	Element
Interface	TouchEvent

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

[1] Not dispatched immediately after compositionstart event.

[2] 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.

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

See also

• compositionstart
• compositionupdate
• compositionend