Window : évènement deviceorientation
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.
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 deviceorientation de l'interface Window est déclenché lorsque des données récentes sont disponibles depuis un capteur d'orientation concernant l'orientation actuelle de l'appareil par rapport au repère terrestre. Ces données sont recueillies à partir d'un magnétomètre intégré à l'appareil.
Voir Explication des données d'orientation et de mouvement pour plus de détails.
Cet évènement n'est pas annulable et ne se propage pas.
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("deviceorientation", (event) => { })
ondeviceorientation = (event) => { }
Type d'évènement
Un objet DeviceOrientationEvent. Hérite de Event.
Propriétés de l'évènement
DeviceOrientationEvent.absoluteLecture seule-
Un booléen indiquant si l'appareil fournit des données d'orientation de façon absolue.
DeviceOrientationEvent.alphaLecture seule-
Un nombre représentant le mouvement de l'appareil autour de l'axe z, exprimé en degrés, avec des valeurs allant de 0 (inclus) à 360 (exclus).
DeviceOrientationEvent.betaLecture seule-
Un nombre représentant le mouvement de l'appareil autour de l'axe x, exprimé en degrés, avec des valeurs allant de -180 (inclus) à 180 (exclus). Cela représente le mouvement avant-arrière de l'appareil.
DeviceOrientationEvent.gammaLecture seule-
Un nombre représentant le mouvement de l'appareil autour de l'axe y, exprimé en degrés, avec des valeurs allant de -90 (inclus) à 90 (exclus). Cela représente le mouvement de gauche à droite de l'appareil.
DeviceOrientationEvent.webkitCompassHeadingNon standard Lecture seule-
Un nombre représentant la différence entre le mouvement de l'appareil autour de l'axe z du repère terrestre et la direction du nord, exprimé en degrés, avec des valeurs allant de 0 à 360.
DeviceOrientationEvent.webkitCompassAccuracyNon standard Lecture seule-
La précision de la boussole exprimée comme une déviation positive ou négative. Elle est généralement de 10.
Exemples
if (window.DeviceOrientationEvent) {
window.addEventListener(
"deviceorientation",
(event) => {
const rotationsDegres = event.alpha; // alpha : rotation autour de l'axe z
const gaucheDroite = event.gamma; // gamma: de gauche à droite
const avantArriere = event.beta; // beta: mouvement avant-arrière
gererEventRotation(avantArriere, gaucheDroite, rotationsDegres);
},
true,
);
}
function gererEventRotation(avantArriere, gaucheDroite, rotationsDegres) {
// faire quelque chose d'étonnant
}
Spécifications
| Specification |
|---|
| Device Orientation and Motion # deviceorientation |
| Device Orientation and Motion # dom-window-ondeviceorientation |