added some detail to compositionupdate regarding canceling composition, and IMEs that don't expose the update
authorschepers
Thu, 27 Aug 2009 05:56:19 +0900
changeset 143 b2e617ba912b
parent 142 f5f8d2b3f30d
child 144 55c253dd97a0
added some detail to compositionupdate regarding canceling composition, and IMEs that don't expose the update
html/DOM3-Events.html
--- a/html/DOM3-Events.html	Thu Aug 27 04:35:48 2009 +0900
+++ b/html/DOM3-Events.html	Thu Aug 27 05:56:19 2009 +0900
@@ -4499,7 +4499,7 @@
                     <td><a href="#events-Events-UIEvent-view"><code>UIEvent.view</code></a>, and <a href="#events-Events-CompositionEvent-data"><code>CompositionEvent.data</code></a>.</td>
                   </tr>
                 </table>
-                A <a href="#glossary-dt-text-composition-system">text composition system</a> updates its active text passage with a new character.
+                A <a href="#glossary-dt-text-composition-system">text composition system</a> updates its active text passage with a new character, which is added to the string in <a href="#events-Events-CompositionEvent-data"><code>CompositionEvent.data</code></a>.  Note that some <a href="#glossary-dt-text-composition-system">text composition systems</a> may not expose this information to the DOM, in which case this event will not fire during the composition process.  If the composition process is canceled, this event will be fired immediately before the <a class="noxref" href="#events-event-compositionend">compositionend</a> event, and the <a href="#events-Events-CompositionEvent-data"><code>CompositionEvent.data</code> attribute will be set to the empty string <span class="issue">(@@ "empty string" or "null"? Is there a distinction?)</span>.</a>
               </dd>
             </dl>
           </div>
@@ -4544,7 +4544,7 @@
                   </tr>
                 </table>
                 A <a href="#glossary-dt-text-composition-system">text composition system</a> completes the composition of its active text passage, or cancels the composition process.  If the result of the <a href="#glossary-dt-text-composition-system">text composition system</a> is not null and does not contain the empty string, this event type will be followed by a <a href="#events-event-textInput">textInput</a> event type with the appropriate <a href="#events-Events-TextEvent-inputMode">inputMode</a> value, such as <a href="#events-DOM_INPUT_METHOD_IME">DOM_INPUT_METHOD_IME</a>, <a href="#events-DOM_INPUT_METHOD_HANDWRITING">DOM_INPUT_METHOD_HANDWRITING</a>, <a href="#events-DOM_INPUT_METHOD_VOICE">DOM_INPUT_METHOD_VOICE</a>, or <a href="#events-DOM_INPUT_METHOD_MULTIMODAL">DOM_INPUT_METHOD_MULTIMODAL</a>.
-                <br/>
+                <br/><br/>
                 <span class="issue">@@ original text: A <a href="#glossary-dt-text-composition-system">text composition system</a> completes the composition of its active text passage.  This event type is similar to a TextInput event but is also sent when an input method cancels composing a text.</span>
               </dd>
             </dl>