You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/reference/react-dom/components/common.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,12 +40,12 @@ Ces props spécifiques à React sont prises en charge pour tous les composants n
40
40
41
41
Ces props standard du DOM sont également prises en charge pour tous les composants natifs :
42
42
43
-
*[`accessKey`](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/accesskey) : une chaîne de caractères. Elle spécifie un raccourci clavier pour l'élément. [Généralement déconseillé](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/accesskey#accessibilité).
43
+
*[`accessKey`](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/accesskey) : une chaîne de caractères. Elle spécifie un raccourci clavier pour l'élément. [Son utilisation est généralement déconseillée](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/accesskey#accessibilité).
44
44
*[`aria-*`](https://developer.mozilla.org/fr/docs/Web/Accessibility/ARIA/Attributes) : les attributs ARIA vous permettent de spécifier les informations de l'arbre d'accessibilité pour cet élément. Consultez [les attributs ARIA](https://developer.mozilla.org/fr/docs/Web/Accessibility/ARIA/Attributes) pour une référence exhaustive. En React, les noms des attributs ARIA sont exactement les mêmes qu'en HTML.
45
45
*[`autoCapitalize`](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/autocapitalize) : une chaîne de caractères. Elle spécifie la façon dont le texte saisi bénéficie de conversions automatiques en majuscules (sur des claviers virtuels).
46
46
*[`className`](https://developer.mozilla.org/fr/docs/Web/API/Element/className) : une chaîne de caractères. Elle spécifie le nom de la classe CSS de l'élément. [Apprenez-en davantage sur la façon d'appliquer des styles CSS](#applying-css-styles).
47
47
*[`contentEditable`](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/contenteditable) : un booléen. S'il vaut `true`, le navigateur permet à l'utilisateur de modifier directement le contenu de l'élément. C'est utilisé pour implémenter des bibliothèques d'éditeurs riches telle que [Lexical](https://lexical.dev/). React avertit quand vous essayez de donner des `children` React à un élément qui dispose de `contentEditable={true}`, parce que React ne sera pas capable de mettre à jour son contenu après les modifications faites par l'utilisateur.
48
-
*[`data-*`](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/data-*) : des attributs sur-mesure qui vous permettent d'associer des données à l'élément, par exemple `data-fruit="banane"`. Ils sont rares en React car vous lisez généralement les données à partir des props ou de l'état.
48
+
*[`data-*`](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/data-*) : des attributs sur-mesure qui vous permettent d'associer des données à l'élément, par exemple `data-fruit="banane"`. Ils sont rarement utilisés en React car vous lisez généralement les données à partir des props ou de l'état.
49
49
*[`dir`](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/dir) : `'ltr'` ou `'rtl'`. Ça spécifie la direction du texte de l'élément.
50
50
*[`draggable`](https://developer.mozilla.org/fr/docs/Web/HTML/Global_attributes/draggable) : un booléen. Il spécifie si l'élément peut être déplacé ou non. Ça fait partie de [l'API HTML de glisser-déposer](https://developer.mozilla.org/fr/docs/Web/API/HTML_Drag_and_Drop_API).
51
51
*[`enterKeyHint`](https://developer.mozilla.org/docs/Web/API/HTMLElement/enterKeyHint) : une chaîne de caractères. Elle spécifie quelle action correspond à la touche entrée d'un clavier virtuel.
@@ -159,9 +159,9 @@ Vous pouvez également passer des attributs personnalisés comme props, par exem
159
159
160
160
Ces événements sont déclenchés pour les éléments [`<form>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/form) :
161
161
162
-
*[`onReset`](https://developer.mozilla.org/fr/docs/Web/API/HTMLFormElement/reset_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché quand un formulaire est réinitialisé.
162
+
*[`onReset`](https://developer.mozilla.org/fr/docs/Web/API/HTMLFormElement/reset_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché quand un formulaire est réinitialisé (ramené à ses valeurs définies par le code HTML).
163
163
*`onResetCapture` : une version de `onReset` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
164
-
*[`onSubmit`](https://developer.mozilla.org/fr/docs/Web/API/HTMLFormElement/submit_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché quand un formulaire est soumis.
164
+
*[`onSubmit`](https://developer.mozilla.org/fr/docs/Web/API/HTMLFormElement/submit_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché quand un formulaire est soumis pour traitement.
165
165
*`onSubmitCapture` : une version de `onSubmit` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
166
166
167
167
Ces événements sont déclenchés pour les éléments [`<dialog>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/dialog). Contrairement aux événements du navigateur, ceux en React sont propagés le long du DOM :
@@ -178,9 +178,9 @@ Ces événements sont déclenchés pour les éléments [`<details>`](https://dev
178
178
179
179
Ces événements sont déclenchés pour les éléments [`<img>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/img), [`<iframe>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/iframe), [`<object>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/object), [`<embed>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/embed), [`<link>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/link), et [`<image>` SVG](https://developer.mozilla.org/fr/docs/Web/SVG/Tutorial/SVG_Image_Tag). Contrairement aux événements du navigateur, ceux en React sont propagés le long du DOM :
180
180
181
-
*`onLoad` : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché quand la ressouce a été chargée.
181
+
*`onLoad` : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché quand la ressouce a été complètement chargée.
182
182
*`onLoadCapture` : une version de `onLoad` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
183
-
*[`onError`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/error_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque la ressource n'a pu être chargée.
183
+
*[`onError`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/error_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque la ressource n'a pas pu être chargée.
184
184
*`onErrorCapture` : une version de `onError` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
185
185
186
186
Ces événements sont déclenchés pour les ressources comme [`<audio>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/audio) et [`<video>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/video). Contrairement aux événements du navigateur, ceux en React sont propagés le long du DOM :
@@ -193,7 +193,7 @@ Ces événements sont déclenchés pour les ressources comme [`<audio>`](https:/
193
193
*`onCanPlayThroughCapture` : une version de `onCanPlayThrough` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
194
194
*[`onDurationChange`](https://developer.mozilla.org/fr/docs/Web/API/HTMLMediaElement/durationchange_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque la durée du média a changé.
195
195
*`onDurationChangeCapture` : une version de `onDurationChange` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
196
-
*[`onEmptied`](https://developer.mozilla.org/fr/docs/Web/API/HTMLMediaElement/emptied_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le média est devenu vide.
196
+
*[`onEmptied`](https://developer.mozilla.org/fr/docs/Web/API/HTMLMediaElement/emptied_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le média est devenu vide (purge du flux par exemple).
197
197
*`onEmptiedCapture` : une version de `onEmptied` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
198
198
*[`onEncrypted`](https://w3c.github.io/encrypted-media/#dom-evt-encrypted) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le navigateur rencontre un média chiffré.
199
199
*`onEncryptedCapture` : une version de `onEncrypted` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
@@ -207,7 +207,7 @@ Ces événements sont déclenchés pour les ressources comme [`<audio>`](https:/
207
207
*`onLoadedMetadataCapture` : une version de `onLoadedMetadata` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
208
208
*[`onLoadStart`](https://developer.mozilla.org/fr/docs/Web/API/HTMLMediaElement/loadstart_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le navigateur commence à charger une ressource.
209
209
*`onLoadStartCapture` : une version de `onLoadStart` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
210
-
*[`onPause`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/pause_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le média est mis en pause.
210
+
*[`onPause`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/pause_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque la lecture du média est mise en pause.
211
211
*`onPauseCapture` : une version de `onPause` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
212
212
*[`onPlay`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/play_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché le média n'est plus en pause.
213
213
*`onPlayCapture` : une version de `onPlay` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
@@ -217,7 +217,7 @@ Ces événements sont déclenchés pour les ressources comme [`<audio>`](https:/
217
217
*`onProgressCapture` : une version de `onProgress` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
218
218
*[`onRateChange`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/ratechange_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le débit de lecture change.
219
219
*`onRateChangeCapture` : une version de `onRateChange` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events)
220
-
*`onResize` : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque la taille de la vidéo change.
220
+
*`onResize` : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque les dimensions de la vidéo changent.
221
221
*`onResizeCapture` : une version de `onResize` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
222
222
*[`onSeeked`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/seeked_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsqu'un déplacement du pointeur de lecture se termine.
223
223
*`onSeekedCapture` : une version de `onSeeked` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
@@ -229,15 +229,15 @@ Ces événements sont déclenchés pour les ressources comme [`<audio>`](https:/
229
229
*`onSuspendCapture` : une version de `onSuspend` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
230
230
*[`onTimeUpdate`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/timeupdate_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le temps de lecture est mis à jour.
231
231
*`onTimeUpdateCapture` : une version de `onTimeUpdate` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
232
-
*[`onVolumeChange`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/volumechange_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le volume a changé.
232
+
*[`onVolumeChange`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/volumechange_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque le volume audio a changé.
233
233
*`onVolumeChangeCapture` : une version de `onVolumeChange` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
234
234
*[`onWaiting`](https://developer.mozilla.org/docs/Web/API/HTMLMediaElement/waiting_event) : un [gestionnaire d'événement `Event`](#event-handler). Cet événement est déclenché lorsque la lecture s'est arrêtée suite à un manque de données.
235
235
*`onWaitingCapture` : une version de `onWaiting` qui se déclenche durant la [phase de capture](/learn/responding-to-events#capture-phase-events).
236
236
237
237
#### Limitations {/*common-caveats*/}
238
238
239
239
- Vous ne pouvez pas passer à la fois `children` et `dangerouslySetInnerHTML`.
240
-
- Certains événements (tels que `onAbort` et `onLoad`) ne sont pas propagés par le navigateur mais le sont en React.
240
+
- Certains événements (tels que `onAbort` et `onLoad`) ne sont pas propagés le long du DOM par le navigateur, mais le sont en React.
241
241
242
242
---
243
243
@@ -267,15 +267,15 @@ La fonction `ref` ne renvoie rien.
Vos gestionnaires d'événements recevront un *objet d'événement React*. On parle aussi parfois « d'événement synthétique ».
270
+
Vos gestionnaires d'événements recevront un *objet d'événement React*. On parle aussi parfois « d'événement synthétique » React.
271
271
272
272
```js
273
273
<button onClick={e=> {
274
274
console.log(e); // Objet d’événement React
275
275
}} />
276
276
```
277
277
278
-
Il respecte le même standard que les événements DOM natifs, mais corrige certaines incohérences des navigateurs.
278
+
Il respecte le même standard que les événements DOM natifs, mais corrige certaines incohérences d'implémentation d'un navigateurs à l'autr.
279
279
280
280
Certains événements React ne correspondent pas directement aux événements natifs des navigateurs. Dans `onMouseLeave` par exemple, `e.nativeEvent` référence un événement `mouseout`. La correspondance spécifique ne fait pas partie de l'API publique et pourrait changer à l'avenir. Si, pour certaines raisons, vous avez besoin de l'événement sous-jacent du navigateur, vous le trouverez dans dans `e.nativeEvent`.
281
281
@@ -753,7 +753,7 @@ Vous écrivez ensuite vos règles CSS dans un fichier CSS séparé :
753
753
754
754
React n'impose aucune façon particulière d'ajouter des fichiers CSS. Dans les cas les plus simples, vous ajouterez une balise [`<link>`](https://developer.mozilla.org/fr/docs/Web/HTML/Element/link) dans votre HTML. Si vous utilisez un outil de *build* ou un framework, consultez sa documentation pour connaître la façon d'ajouter un fichier CSS à votre projet.
755
755
756
-
Parfois, les valeurs de style dépendent de vos données. Utilisez l'attribut `style` pour passer certains styles dynamiquement :
756
+
Parfois, les valeurs de style que vous souhaitez utiliser dépendent de vos données. Utilisez l'attribut `style` pour passer certains styles dynamiquement :
### Gérer des événements du pointeur {/*handling-pointer-events*/}
1051
1051
1052
-
Cet exemple montre quelques [événements liés aux pointeurs](#pointerevent-handler) courants et illustre leurs moments de déclenchement.
1052
+
Cet exemple montre quelques [événements liés aux pointeurs](#pointerevent-handler) courants et permet de suivre la chronologie de leurs déclenchements.
0 commit comments