Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

DeviceMotionEvent.accelerationIncludingGravity

Baseline 2023
Newly available

Depuis ⁨September 2023⁩, cette fonctionnalité fonctionne sur les appareils et les versions de navigateur les plus récents. Elle peut ne pas fonctionner sur les appareils ou navigateurs plus anciens.

La propriété accelerationIncludingGravity renvoie la valeur d'accélération enregistrée par l'appareil, en mètres par seconde au carré (m/s2). Contrairement à DeviceMotionEvent.acceleration qui compense pour tenir compte de l'influence de la gravité, sa valeur est la somme de l'accélération de l'appareil induite par l'utilisateur et de celle provoquée par la gravité.

Cette valeur n'est pas aussi utile que DeviceMotionEvent.acceleration, mais elle peut être la seule disponible, par exemple pour un appareil qui ne peut supprimer la gravité des données d'accélération puisqu'il ne l'utilise pas, comme les périphériques sans gyroscope.

Syntaxe

js
var acceleration = instanceOfDeviceMotionEvent.accelerationIncludingGravity;

Valeur

La propriété accelerationIncludingGravity est un objet fournissant une information sur l'accélération des 3 axes. Pour chacun d'eux, elle est représentée par leur propre propriété :

x

Représente l'accélération sur l'axe x qui est l'axe est-ouest.

y

Représente l'accélération sur l'axe y qui est l'axe nord-sud

z

Représente l'accélération sur l'axe z qui est l'axe haut-bas

Spécifications

Specification
Device Orientation and Motion
# dom-devicemotionevent-accelerationincludinggravity

Compatibilité des navigateurs

Voir aussi