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 | CompositionEvent |
| 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. |
We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | (Yes)[1] | (Yes) | 9.0 (9.0)[2] | (Yes) | No support | ? |
| Feature | Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | (Yes) | 9.0 (9.0)[2] | ? | No support |
[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.
© 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/Events/compositionupdate