---
title: CompositionEvent
slug: Web/API/CompositionEvent
tags:
  - API
  - CompositionEvent
  - DOM
  - 事件
  - 参考
translation_of: Web/API/CompositionEvent
---
<div>{{APIRef("DOM Events")}}</div>

<p>DOM 接口 <strong><code>CompositionEvent</code></strong> 表示用户间接输入文本（如使用输入法）时发生的事件。此接口的常用事件有{{domxref("Element/compositionstart_event", "compositionstart")}}, {{domxref("Element/compositionupdate_event", "compositionupdate")}} 和 {{domxref("Element/compositionend_event", "compositionend")}}</p>

<p>{{InheritanceDiagram}}</p>

<h2 id="构造函数">构造函数</h2>

<dl>
 <dt>{{domxref("CompositionEvent.CompositionEvent()", "CompositionEvent()")}}</dt>
 <dd>创建一个新的 <code>CompositionEvent</code> 对象实例。</dd>
</dl>

<h2 id="属性">属性</h2>

<p><em>这个接口也从{{domxref("UIEvent")}} 和 {{domxref("Event")}} 继承属性。</em></p>

<dl>
 <dt>{{domxref("CompositionEvent.data")}} {{readonlyinline}}</dt>
 <dd>返回触发事件的输入方法所产生的字符；取决于生成 <code>CompositionEvent</code> 对象的事件类型，结果会有所不同。</dd>
 <dt>{{domxref("CompositionEvent.locale")}} {{readonlyinline}} {{deprecated_inline}}</dt>
 <dd>返回当前输入方法的场景（例如，使用输入法编辑器进行输入合成时，场景就是键盘布局）。</dd>
</dl>

<h2 id="方法">方法</h2>

<p><em>这个接口也从 {{domxref("UIEvent")}} 和 {{domxref("Event")}} 继承方法。</em></p>

<dl>
 <dt>{{domxref("CompositionEvent.initCompositionEvent()")}} {{deprecated_inline}}</dt>
 <dd>初始化 <code>CompositionEvent</code> 对象的所有属性。</dd>
</dl>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">注释</th>
  </tr>
  <tr>
   <td>{{SpecName('UI Events', '#interface-compositionevent', 'CompositionEvent')}}</td>
   <td>{{Spec2('UI Events')}}</td>
   <td></td>
  </tr>
  <tr>
   <td>{{SpecName('DOM3 Events', '#idl-compositionevent', 'CompositionEvent')}}</td>
   <td>{{Spec2('DOM3 Events')}}</td>
   <td></td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>



<p>{{Compat("api.CompositionEvent")}}</p>

<h2 id="参见">参见</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/Element/compositionstart_event">compositionstart</a></li>
 <li><a href="https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionend_event">compositionend</a></li>
 <li><a href="https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionupdate_event">compositionupdate</a></li>
 <li><a href="/en-US/docs/DOM/Event/UIEvent" title="UIEvent">UIEvent</a></li>
 <li><a href="/en-US/docs/DOM/event" title="Event">Event</a></li>
</ul>