element.dispatchEvent

Résumé

Envoie un évènement dans le système d'évènements. L'évènement est toujours soumis au même comportement de capture et de propagation que les évènements envoyés directement.

Syntaxe

bool =element.dispatchEvent(evenement)

Paramètres

element

La cible (target) de l'évènement.

evenement

Un objet event à envoyer.

bool

La valeur renvoyée est false si au moins un des gestionnaires d'évènements gérant cet évènement a appelé preventDefault. Dans les autres cas, la valeur renvoyée est true.

Notes

Comme montré dans l'exemple qui précède, dispatchEvent est la dernière étape du processus création-initialisation-envoi, qui est utilisé pour envoyer des évènements manuellement dans le modèle évènementiel de l'implémentation.

L'évènement peut-être créé avec la méthode document.createEvent et initialisé avec initEvent ou toute autre méthode d'initialisation plus spécifique, comme initMouseEvent ou initUIEvent.

Voir également

• Référence de DOM Event.

Spécification

• DOM Level 2 Events: dispatchEvent (en) — traduction en français (non normative)