aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/deviceorientationevent/index.md
blob: 4c0b77dcab79fc40741028ced3056290df7a07e5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
---
title: DeviceOrientationEvent
slug: Web/API/DeviceOrientationEvent
tags:
  - B2G
  - Device Orientation
  - Experimental
  - Firefox OS
  - Mobile
  - Orientation
  - WebAPI
  - events
  - évènements
translation_of: Web/API/DeviceOrientationEvent
---
{{ApiRef}}{{SeeCompatTable}}

## Sommaire

L'évènement `DeviceOrientationEvent` met à la disposition du développeur des informations sur l'orientation de l'appareil visitant une page Web

> **Attention :** à l'heure actuelle, Firefox et Chrome ne gèrent pas les cordonnées de la même façon. Tenez-en compte lors de l'utilisation de cette API.

## Propriétés

- {{domxref("DeviceOrientationEvent.absolute")}} {{readonlyinline}}
  - : Un booléen, indiquant si l'appareil partage les informations sur son orientation absolue.
- {{domxref("DeviceOrientationEvent.alpha")}} {{readonlyinline}}
  - : Un nombre, représentant le mouvement de l'appareil sur l'axe « z » exprimé en degrés sur une échelle de 0° à 360°.
- {{domxref("DeviceOrientationEvent.beta")}} {{readonlyinline}}
  - : Un Nombre représentant le déplacement de l'appareil sur l'axe « x », exprimé en degrés sur une échelle de -180° à 180°.
- {{domxref("DeviceOrientationEvent.gamma")}} {{readonlyinline}}
  - : Un nombre représentant le déplacement de l'appareil sur l'axe « y », exprimé en degrés sur une échelle de -90° à 90°.

## Exemple

```js
window.addEventListener('deviceorientation', function(event) {
  console.log("z : " + event.alpha + "\n x : " + event.beta + "\n y : " + event.gamma);
});
```

## Spécifications

| Spécification                                | Statut                                   | Commentaires         |
| -------------------------------------------- | ---------------------------------------- | -------------------- |
| {{SpecName('Device Orientation')}} | {{Spec2('Device Orientation')}} | Définition initiale. |

## Compatibilité des navigateurs

{{Compat("api.DeviceMotionEvent")}}

## Voir aussi

- {{ event("deviceorientation") }}
- {{ domxref("DeviceMotionEvent") }}
- {{ event("devicemotion") }}
- [Detecting device orientation](/en-US/docs/WebAPI/Detecting_device_orientation)
- [Orientation and motion data explained](/en/DOM/Orientation_and_motion_data_explained)