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

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

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

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

Spécifications

Specification
Device Orientation and Motion

Compatibilité des navigateurs

api.Window.deviceorientation_event

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
deviceorientation event

Legend

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

Full support
Full support
Uses a non-standard name.
Has more compatibility info.

api.Window.devicemotion_event

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
devicemotion event

Legend

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

Full support
Full support

api.Window.deviceorientationabsolute_event

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
deviceorientationabsolute event

Legend

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

Full support
Full support
No support
No support

api.DeviceOrientationEvent

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
DeviceOrientationEvent
DeviceOrientationEvent() constructor
absolute
alpha
beta
gamma
requestPermission() static method
Experimental

Legend

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

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.

api.DeviceMotionEvent

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
DeviceMotionEvent
DeviceMotionEvent() constructor
acceleration
accelerationIncludingGravity
interval
requestPermission() static method
Experimental
rotationRate

Legend

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

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

api.DeviceMotionEventAcceleration

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
DeviceMotionEventAcceleration
x
y
z

Legend

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

Full support
Full support
No support
No support

api.DeviceMotionEventRotationRate

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
DeviceMotionEventRotationRate
alpha
beta
gamma

Legend

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

Full support
Full support
No support
No support

Voir aussi