HTMLElement: beforeinput event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Expérimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

L'évènement DOM beforeinput est émis quand la valeur d'un élément <input>, <select>, ou <textarea> est sur le point d'être modifié. L'évènement s'applique également aux éléments ayant l'attribut contenteditable actif, et à tout élément quand le designMode est activé.

Dans le cas de contenteditable et designMode, la cible de l'évènement est l'hôte d'édition. Si ces propriétés s'appliquent à plusieurs éléments, l'hôte d'édition est le plus proche ancêtre dont le parent n'est pas éditable.

Bouillonne Oui
Annulable Oui
Interface InputEvent
Propriété gestionnaire d'évènement Aucune
Sync / Async Sync
Composé Oui
Action par défaut Mettre à jour l'élément DOM

Exemples

Cet exemple affiche la valeur de l'élément <input> juste avant qu'elle soit modifiée.

HTML

html
<input placeholder="Saisissez du texte" name="name" />
<p id="values"></p>

JavaScript

js
const input = document.querySelector("input");
const log = document.getElementById("values");

input.addEventListener("beforeinput", updateValue);

function updateValue(e) {
  log.textContent = e.target.value;
}

Résultat

Spécifications

Specification
UI Events
# event-type-beforeinput

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
beforeinput event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi

  • Évènement associé : input