API d’orientation de l’écran

Avec l’introduction de la prise en charge de l’API d’orientation de l’écran (Screen Orientation) du W3C dans Internet Explorer 11, vous pouvez détecter l’orientation actuelle de l’écran, être informé de tout changement d’orientation et verrouiller l’orientation sur un état spécifique.

Important   Cette fonctionnalité n’est pas prise en charge dans IE11 sur Windows 7.

L’API d’orientation de l’écran vous permet soit d’empêcher le navigateur de réorganiser automatiquement le contenu de votre application Web lorsque l’utilisateur change l’orientation de son appareil, soit d’ignorer son comportement. Lorsque vous utilisez des événements d’orientation de l’appareil, vous pouvez également utiliser l’API d’orientation de l’écran pour verrouiller l’écran. Ainsi, les données relatives à l’orientation de l’appareil et aux capteurs de mouvement sont correctes, leur validité ou leur degré de complexité n’étant pas affecté lorsque l’utilisateur change de façon aléatoire l’orientation de l’écran.

Valeurs d’orientation

L’API d’orientation de l’écran utilise les concepts suivants pour décrire les divers états d’orientation sur différents appareils. Les schémas donnés ci-après en exemple supposent que l’orientation normale (par défaut) des appareils est la suivante :

Schéma d’un appareil mobile (orientation portrait) et d’une tablette (orientation paysage).

Valeur d’orientationDescriptionOrientation de l’appareil
portrait-primaryL’écran est en mode portrait, et le côté droit de l’appareil hôte est en haut (si son orientation normale est en mode portrait) ou l’appareil hôte est tourné de 90 degrés dans le sens des aiguilles d’une montre (si son orientation normale est en mode paysage).Illustration de l’orientation de l’appareil mobile et de la tablette en mode "portrait-primary"
landscape-primaryL’écran est en mode paysage, et le côté droit de l’appareil hôte est en haut (si son orientation normale est en mode paysage) ou l’appareil hôte est tourné de 90 degrés dans le sens inverse des aiguilles d’une montre (si son orientation normale est en mode portrait).Illustration de l’orientation de l’appareil mobile et de la tablette en mode "landscape-primary"
portrait-secondaryL’écran est en mode portrait, et l’appareil hôte est à l’envers (si son orientation normale est en mode portrait) ou l’appareil hôte est tourné de 90 degrés dans le sens inverse des aiguilles d’une montre (si son orientation normale est en mode paysage).Illustration de l’orientation de l’appareil mobile et de la tablette en mode "portrait-secondary"
landscape-secondaryL’écran est en mode paysage, et l’appareil hôte est à l’envers (si son orientation normale est en mode paysage) ou l’appareil hôte est tourné de 90 degrés dans le sens des aiguilles d’une montre (si son orientation normale est en mode portrait).Illustration de l’orientation de l’appareil mobile et de la tablette en mode "landscape-secondary"

 

Détection des changements et verrouillage de l’orientation

Pour surveiller les changements apportés à l’orientation de l’écran de l’utilisateur, écoutez l’événement MSOrientationChange de l’objet screen. Celui-ci communique un objet Event simple. À partir de là, vous pouvez déterminer l’orientation actuelle de l’écran à partir de la propriété msOrientation de l’objet screen :


function orientationChangeHandler(evt) {
  var orientation = evt.target.msOrientation;
  // Respond to the screen orientation change
}

Pour verrouiller l’écran sur une orientation spécifique, appelez la méthode msLockOrientation, puis passez-lui une ou plusieurs des valeurs décrites dans la section Valeurs d’orientation ci-dessus :


screen.msLockOrientation("portrait-primary", "portrait-secondary"); 

Vous pouvez également lui passer une des valeurs « raccourcies » suivantes :

TermeDescription

portrait

Valeur qui représente à la fois le cas portrait-primary et le cas portrait-secondary.

landscape

Valeur qui représente à la fois le cas landscape-primary et le cas landscape-secondary.

 

Il est uniquement possible de verrouiller l’orientation de l’écran quand Internet Explorer est en mode plein écran (lorsque l’utilisateur appuie sur F11 ou via l’API Fullscreen).

Si une seule orientation est verrouillée, l’écran reste sur l’orientation donnée et ne change que lorsque l’orientation de l’écran est déverrouillée. Sinon, l’orientation de l’écran peut passer de l’une à l’autre des orientations spécifiées dans le verrouillage lorsque l’utilisateur fait pivoter l’appareil hôte.

Pour déverrouiller l’orientation, appelez la méthode screen.msUnlockOrientation.

Informations de référence sur les API

msOrientation
MSOrientationChange
msLockOrientation
msUnlockOrientation

Spécification

API d’orientation de l’écran

 

 

Afficher:
© 2014 Microsoft