Element : évènement pointerrawupdate
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
L'évènement pointerrawupdate est déclenché lorsqu'un pointeur modifie des propriétés qui ne déclenchent pas les évènements pointerdown ou pointerup.
Voir pointermove pour une liste de ces propriétés.
L'évènement pointerrawupdate peut avoir des évènements fusionnés s'il existe déjà un autre évènement pointerrawupdate avec le même ID de pointeur qui n'a pas été distribué dans la boucle d'évènements.
Si les évènements sont fusionnés, la cible (target) de l'évènement distribué est la même que celle du dernier évènement fusionné.
Pour des informations sur les évènements fusionnés, voir la documentation de PointerEvent.getCoalescedEvents().
La différence entre pointerrawupdate et pointermove réside dans leur fréquence de déclenchement.
Un navigateur peut retarder les évènements pointermove pour améliorer les performances, tandis que les évènements pointerrawupdate sont distribués aussi rapidement et aussi fréquemment que le navigateur peut les produire.
Les deux types d'évènements peuvent être fusionnés, mais pointerrawupdate l'est moins, donc ses écouteurs s'exécutent plus souvent.
Un seul évènement transporte les mêmes valeurs de propriétés dans les deux cas, donc pointerrawupdate n'est pas plus précis dans l'espace ou le temps que l'évènement pointermove couvrant le même mouvement.
pointerrawupdate est donc destiné aux applications qui nécessitent une gestion des entrées à plus faible latence que ce que pointermove offre, comme le dessin ou le glissement qui, autrement, sont visiblement en retard par rapport au pointeur.
Comme les évènements arrivent plus souvent, une application qui suit leur rythme peut également sembler plus fluide.
Cependant, comme l'écoute des évènements pointerrawupdate peut affecter les performances, vous ne devez ajouter ces écouteurs que si votre JavaScript a besoin d'évènements à haute fréquence et peut les traiter aussi rapidement qu'ils sont distribués.
Pour la plupart des cas d'utilisation, les autres types d'évènements de pointeur doivent suffire.
Une application qui ne peut pas suivre le rythme semble moins réactive plutôt que plus, donc une optimisation importante à l'intérieur du gestionnaire d'évènements est nécessaire.
Cet évènement se propage et est composé, mais n'est pas annulable et n'a pas d'action par défaut.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènements.
addEventListener("pointerrawupdate", (event) => { })
onpointerrawupdate = (event) => { }
Type d'évènement
Un objet PointerEvent. Hérite de Event.
Exemples
canvas.addEventListener("pointerrawupdate", (event) => {
const events = event.getCoalescedEvents();
if (events.length > 1) {
console.log("Évènements fusionnés :", events.length);
for (const coalescedEvent of events) {
// Faire quelque chose avec les évènements fusionnés.
}
} else {
// Faire quelque chose avec l'évènement.
console.log("Évènement brut", event);
}
});
Spécifications
| Spécification |
|---|
| Pointer Events # pointerrawupdate |
| Pointer Events # dom-globaleventhandlers-onpointerrawupdate |
Compatibilité des navigateurs
Voir aussi
- Évènements associés :