A phonegap/cordova plugin for locking the orientation
Switch branches/tags
Nothing to show
Clone or download
Latest commit 82b4254 Jul 12, 2014



Android Cordova plugin for locking/unlocking the screen orientation from Javascript

Calling the plugin

From your JavaScript code call window.plugins.orientationLock.unlock() to unlock orientation, window.plugins.orientationLock.lock("portrait") or window.plugins.orientationLock.lock("landscape") to lock your screen to the specified orientation.

To start your Cordova application pre-locked place setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT); or setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE); in the onCreate() of your Cordova activity.

Once unlocked, you can track orientation changes with the regular orientationchange event:

window.addEventListener("orientationchange", function() {

Adding the Plugin to your project

Using this plugin requires Apache Cordova for Android. Within your project, run the following command:

cordova plugin add https://github.com/cogitor/PhoneGap-OrientationLock.git