Évènements relatifs à l'orientation de l'appareil

Baseline 2023

Newly available

Since September 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Les évènements relatifs à l'orientation de l'appareil permettent de détecter l'orientation physique d'un appareil, et le mouvement de l'appareil.

Concepts et utilisation

Les appareils mobiles disposent généralement de capteurs comme des gyroscopes, des boussoles, et des accéléromètres qui permettent aux applications qui s'y exécutent de détecter l'orientation et le mouvement de l'appareil.

L'API web sur les évènements relatifs à l'orientation de l'appareil permettent d'écrire des applications web dont le comportement peut être adapté à l'orientation de l'appareil et qui peuvent réagir au déplacement de l'appareil.

Par exemple, on pourra gérer les évènements liés à l'orientation de l'appareil dans les scénarios suivants :

  • Pour les jeux, permettre de contrôler le déplacement de personnages ou d'objets en jeu en inclinant ou en déplaçant l'appareil.
  • Pour les applications cartographiques, permettre de réorienter la carte selon la position de l'appareil et fournir des indications de navigation mises à jour en fonction des déplacements.
  • Pour la reconnaissance de certains gestes. Par exemple, on pourra identifier que l'appareil est secoué et déclencher une action en conséquence, comme la réinitialisation d'un champ.

Note : Cette API est bien prise en charge par les navigateurs mobiles. Pour les navigateurs de bureaux, il pourra y avoir des limitations liées aux capacités matérielles de ces appareils. Toutefois, ces contraintes sont rarement un problème, car l'API repose principalement sur une utilisation avec des appareils dotés de capteurs adéquats.

Interfaces

DeviceOrientationEvent

Représente les changements d'orientation physique de l'appareil.

DeviceMotionEvent

Représente les changements d'accélération de l'appareil, ainsi que la vitesse de rotation.

DeviceMotionEventAcceleration (en-US)

Représente l'accélération de l'appareil sur les trois axes.

DeviceMotionEventRotationRate

Représente la vitesse de rotation de l'appareil sur les trois axes.

Évènements

deviceorientation

Déclenché lorsque de nouvelles données captées par l'appareil sont disponibles à propos de l'orientation de l'appareil dans le système de coordonnées terrestre.

devicemotion

Déclenché à intervalle régulier pour indiquer l'accélération reçue par l'appareil à cet instant, ainsi que sa vitesse de rotation.

deviceorientationabsolute (en-US)

Déclenché lorsque les informations relatives à l'orientation absolue changent.

Spécifications

Specification
DeviceOrientation Event Specification

Compatibilité des navigateurs

api.Window.deviceorientation_event

BCD tables only load in the browser

api.Window.devicemotion_event

BCD tables only load in the browser

api.Window.deviceorientationabsolute_event

BCD tables only load in the browser

api.DeviceOrientationEvent

BCD tables only load in the browser

api.DeviceMotionEvent

BCD tables only load in the browser

api.DeviceMotionEventAcceleration

BCD tables only load in the browser

api.DeviceMotionEventRotationRate

BCD tables only load in the browser

Voir aussi