---
title: CompositionEvent
slug: Web/API/CompositionEvent
tags:
  - API
  - DOM
  - Evènement
translation_of: Web/API/CompositionEvent
---
<p>{{APIRef("DOM Events")}}</p>

<p>Le <code>CompositionEvent DOM</code> représente les évènements qui <span id="result_box" lang="fr"><span>se produisent en raison de l'utilisateur entrant indirectement le texte.</span></span></p>

<h2 id="Constructeur">Constructeur</h2>

<dl>
 <dt>{{domxref("CompositionEvent.CompositionEvent()", "CompositionEvent()")}}</dt>
 <dd>Crée une nouvelle instance d'objet <code>CompositionEvent</code> .</dd>
</dl>

<h2 id="Propriétés">Propriétés</h2>

<p><em>Cette interface hérite également des propriétés de son parent, {{domxref("UIEvent")}} et son ancêtre — {{domxref("Event")}}.</em></p>

<dl>
 <dt>{{domxref("CompositionEvent.data")}} {{readonlyinline}}</dt>
 <dd>Renvoie les caractères générés par la méthode d'entrée <span id="result_box" lang="fr"><span>qui a relevé l'événement ;</span> <span>cela varie en fonction du type d'événement ayant généré l'objet <code>CompositionEvent</code>.</span></span></dd>
 <dt>{{domxref("CompositionEvent.locale")}} {{readonlyinline}} {{deprecated_inline}}</dt>
 <dd><span id="result_box" lang="fr"><span>Renvoie les paramètres régionaux de la méthode de saisie actuelle (par exemple, les paramètres régionaux de disposition du clavier si la composition est associée à IME).</span></span></dd>
</dl>

<h2 id="Méthodes">Méthodes</h2>

<p><em>Cette interface hérite également des méthodes de son parent, {{domxref("UIEvent")}} et son ancêtre — {{domxref("Event")}}.</em></p>

<dl>
 <dt>{{domxref("CompositionEvent.initCompositionEvent()")}} {{deprecated_inline}}</dt>
 <dd>Initialise les attributs d'un objet <code>CompositionEvent.</code></dd>
</dl>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">Statut</th>
   <th scope="col">Commentaire</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="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<div>


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

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li><code>compositionstart</code></li>
 <li><code>compositionend</code></li>
 <li><code>compositionupdate</code></li>
 <li><a href="https://developer.mozilla.org/fr/docs/Web/API/UIEvent" title="UIEvent">UIEvent</a></li>
 <li><a href="https://developer.mozilla.org/fr/docs/Web/API/Event" title="Event">Event</a></li>
</ul>