Window : évènement deviceorientation
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis septembre 2023.
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.
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
| Spécification |
|---|
| Device Orientation and Motion # deviceorientation |
| Device Orientation and Motion # dom-window-ondeviceorientation |