1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
---
title: compositionstart
slug: Web/API/Element/compositionstart_event
tags:
- Element
- Event
- Input method
- Reference
- compositionstart
translation_of: Web/API/Element/compositionstart_event
original_slug: Web/Events/compositionstart
---
<div>{{APIRef}}</div>
<p>L'événement <strong><code>compositionstart</code></strong> est déclenché lorsqu'un système de composition de texte tel qu'une {{glossary("input method editor","méthode de saisie")}} démarre une nouvelle session de composition.</p>
<p>Par exemple, cet événement pourrait être déclenché après qu'un utilisateur a commencé à saisir un caractère chinois en utilisant un <a href="https://en.wikipedia.org/wiki/Pinyin">Pinyin</a> IME.</p>
<table class="properties">
<tbody>
<tr>
<th>Propagation</th>
<td>Oui</td>
</tr>
<tr>
<th>Annulable</th>
<td>Oui</td>
</tr>
<tr>
<th>Interface</th>
<td>{{domxref("CompositionEvent")}}</td>
</tr>
<tr>
<th>Propriété du gestionnaire d'événements</th>
<td>Aucune</td>
</tr>
</tbody>
</table>
<h2 id="Examples">Exemples</h2>
<pre class="brush: js">const inputElement = document.querySelector('input[type="text"]');
inputElement.addEventListener('compositionstart', (event) => {
console.log(`generated characters were: ${event.data}`);
});</pre>
<h3 id="Live_example">Exemple concret</h3>
<h4 id="HTML">HTML</h4>
<pre class="brush: html"><div class="control">
<label for="name">Sur macOS, cliquez dans la zone de texte ci-dessous,<br> puis tapez <kbd>option</kbd> + <kbd>`</kbd>, puis <kbd>a</kbd> :</label>
<input type="text" id="example" name="example">
</div>
<div class="event-log">
<label>Event log:</label>
<textarea readonly class="event-log-contents" rows="8" cols="25"></textarea>
<button class="clear-log">Clear</button>
</div></pre>
<pre class="brush: css hidden">body {
padding: .2rem;
display: grid;
grid-template-areas: "control log";
}
.control {
grid-area: control;
}
.event-log {
grid-area: log;
}
.event-log-contents {
resize: none;
}
label, button {
display: block;
}
input[type="text"] {
margin: .5rem 0;
}
kbd {
border-radius: 3px;
padding: 1px 2px 0;
border: 1px solid black;
}
</pre>
<h4 id="JS">JS</h4>
<pre class="brush: js">const inputElement = document.querySelector('input[type="text"]');
const log = document.querySelector('.event-log-contents');
const clearLog = document.querySelector('.clear-log');
clearLog.addEventListener('click', () => {
log.textContent = '';
});
function handleEvent(event) {
log.textContent = log.textContent + `${event.type}: ${event.data}\n`;
}
inputElement.addEventListener('compositionstart', handleEvent);
inputElement.addEventListener('compositionupdate', handleEvent);
inputElement.addEventListener('compositionend', handleEvent);
</pre>
<h4 id="Result">Résultat</h4>
<p>{{ EmbedLiveSample('Live_example', '100%', '180px') }}</p>
<h2 id="Specifications">Spécifications</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Spécification</th>
<th scope="col">Statut</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('UI Events', '#event-type-compositionstart')}}</td>
<td>{{Spec2('UI Events')}}</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilités_navigateur">Compatibilités navigateur</h2>
<p>{{Compat("api.Element.compositionstart_event")}}</p>
<h2 id="See_also">Voir aussi</h2>
<ul>
<li>Événements liés : {{domxref("Element/compositionend_event", "compositionend")}}, {{domxref("Element/compositionupdate_event", "compositionupdate")}}.</li>
</ul>
|
