compositionstart

The compositionstart event is fired when the composition of a passage of text is prepared (similar to keydown for a keyboard input, but 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 Yes
Target objects Element
Interface TouchEvent

Properties

Property Type Description
target Read only EventTarget Focused element processing the composition.
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 (window of the document)
detail Read only long (float) 0.
data Read only DOMString (string) The original string being edited, otherwise the empty string.
locale Read only DOMString (string) The language code for the composition event, if available; otherwise, the empty string.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes)[1] 9.0 (9.0)[2] (Yes)[3] No support (Yes)[1]
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? 9.0 (9.0)[2] ? ? ?

[1] The data attribute value is wrong.

[2] The event was fired in versions of Gecko before 9.0, but didn't have the DOM Level 3 attributes and methods.

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

According to the DOM Level3 specification, compositionstart is cancelable; however, Gecko doesn't currently let you cancel them.

Gecko fires this event when IME starts composition, and some platforms don't have an API for canceling composition once it's begun. In addition, Gecko can't know whether a keyboard event will start composition or not until IME actually starts composition. Because of this, event.preventDefault() doesn't work on compositionstart events in Gecko.

Gecko's editors (for example, <input type="text">, <div contenteditable/>, and designMode) start composition after the bubble phase of compositionstart. So, by the time your compositionstart handler is called, no contents have not been modified.

[3] The data value is always empty.

Document Tags and Contributors

Tags: 
 Last updated by: nicolo-ribaudo,