Skip to main content

Screen Orientation

Cordova plugin to set/lock the screen orientation in a common way.

Requires Cordova plugin: cordova-plugin-screen-orientation. For more info, please see the Screen Orientation plugin docs.

Stuck on a Cordova issue?

Don't waste precious time on plugin issues.

If you're building a serious project, you can't afford to spend hours troubleshooting. Ionic’s experts offer premium advisory services for both community plugins and premier plugins.


$ npm install cordova-plugin-screen-orientation $ npm install @ionic-native/screen-orientation $ ionic cap sync

Supported Platforms#

  • Android
  • iOS
  • Windows



Learn more about using Ionic Native components in React


import { ScreenOrientation } from '@ionic-native/screen-orientation/ngx';
constructor(private screenOrientation: ScreenOrientation) { }

// get currentconsole.log(this.screenOrientation.type); // logs the current orientation, example: 'landscape'
// set to landscapethis.screenOrientation.lock(this.screenOrientation.ORIENTATIONS.LANDSCAPE);
// allow user rotatethis.screenOrientation.unlock();
// detect orientation changesthis.screenOrientation.onChange().subscribe(   () => {       console.log("Orientation Changed");   });