L'évènement DOM input (entrée) est déclenché de façon synchrone quand la valeur d'un élément <input> (entrée), <select> (sélection) ou <textarea> (zone de texte) est modifiée. (Pour les éléments input avec type=checkbox (case à cocher) ou type=radio , l'évènement input n'est pas lancé quand l'utilisateur clique sur le contrôle, parce que la valeur attribuée ne peut être changée).
De plus, l'évènement input se déclenche sur les éditeurs contenteditable quand son contenu est modifié. Dans ce cas, l'évènement cible est l'élément "editing host" (hôte de l'édition) . S'il y a deux éléments ou plus qui ont contenteditable à true (vrai), "editing host" est l'élément ancêtre le plus proche dont le parent n'est pas modifiable . De même, il est déclenché sur l'élément racine des éditeurs designMode .
Information générale
- Spécification
- HTML5, DOM Level 3 Events
- Interface
Event,InputEvent- Propagation
- Oui
- Annulable
- Non
- Cible
- Élement
- Action par défaut
- La valeur ou le contenu est modifié
Propriétés
| Property | Type | Description |
|---|---|---|
target Lecture seule |
EventTarget |
The event target (the topmost target in the DOM tree). |
type Lecture seule |
DOMString |
The type of event. |
bubbles Lecture seule |
Boolean |
Whether the event normally bubbles or not. |
cancelable Lecture seule |
Boolean |
Whether the event is cancellable or not. |
Compatibilité des navigateurs
| Fonctionnalité | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | (Oui) | (Oui) | (Oui)[1] | 9[2][3] | (Oui)[4] | (Oui) |
immediately after compositionupdate |
(Oui) | (Oui) | 12 (12) | (Oui) | 15 | (Oui) |
on contenteditable element |
(Oui) | (Oui) | 14 (14) | Pas de support[5]
|
15 | (Oui) |
when designMode is "on" |
(Oui) | ? | 14 (14) | Pas de support | 15 | (Oui) |
data |
? | ? | Pas de support | ? | ? | ? |
isComposing |
Pas de support | ? | 31 (31) | Pas de support | Pas de support | Pas de support |
| <select> | (Oui) | Pas de support | 49 (49) | Pas de support | ? | ? |
| Fonctionnalité | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | (Oui) | (Oui) | (Oui) | (Oui) | ? | ? | (Oui) |
immediately after compositionupdate |
? | ? | (Oui) | 12.0 (12) | ? | ? | ? |
on contenteditable element |
? | (Oui) | ? | 14.0 (14) | ? | ? | (Oui) |
when designMode is "on" |
? | ? | ? | 14.0 (14) | ? | ? | ? |
data |
? | ? | ? | Pas de support | ? | ? | ? |
isComposing |
Pas de support | Pas de support | ? | 31.0 (31) | Pas de support | Pas de support | Pas de support |
| <select> | ? | (Oui) | ? | Pas de support | ? | ? | ? |
[1] Avant Gecko 12.0 {GeckoRelease ("12.0")}}, Gecko ne déclenchait pas les événements "input" pendant que la composition était en cours en utilisant des IME ou lorsque des clés mortes étaient utilisées sur Mac OS X.
[2] IE 9 ne déclenche pas un événement "input" lorsque l'utilisateur supprime des caractères d'une entrée (par exemple en appuyant sur Retour arrière ou Suppr., ou en utilisant l'opération "Cut" (couper)).
[3] IE 10 et 11 ont un bogue, l'évènement "input" s'y déclenche lors des changements de l'attribut "placeholder" (espace réservé).
[4] Avant Opera 15, Opera ne déclenchait pas un événement "input" après la suppression du texte dans un champ de saisie .
[5] La cible de l'événement est l'élément " innermost" à la position du curseur.
Voir aussi
L'évènement change est lié . "change" se déclenche moins souvent que "input" - il n'est lancé que lorsque les modifications sont validées par l'utilisateur.