Uniting our global community of Ionic developers and contributors. May 25, 2022.
Many apps work well in portrait and landscape device orientations. However, many don’t, and there are good reasons to require an app to function solely or occasionally in one mode or the other.
To set a global setting for orientation in your Capacitor app, you’ll set the configuration value necessary for the platform you’re targeting.
iOS allows for different screen orientations to be supported on iPhones and iPads. To limit the allowed orientations for iOS, open Xcode and open the
Info.plist file. Find the following keys:
Supported interface orientation and
Supported interface orientation (iPad). Using these values, specify the different orientations you would like supported for iPhones and for iPads.
If editting the
Info.plist file directly look for the following keys:
UISupportedInterfaceOrientations~ipad. For example, the following settings will limit the orientation to right-side-up
Portrait on iPhones and either of the
Landscape orientations on iPads:
<key>UISupportedInterfaceOrientations</key> <array> <string>UIInterfaceOrientationPortrait</string> </array> <key>UISupportedInterfaceOrientations~ipad</key> <array> <string>UIInterfaceOrientationLandscapeRight</string> <string>UIInterfaceOrientationLandscapeLeft</string> </array>
On Android, orientation can be set by modifying the
AndroidManifest.xml and setting
android:screenOrientation on the
<activity> entry for your main app activity. See the
Android Manifest Documentation for details on the possible entries.
Many apps need to support multiple orientations, with the ability to lock orientations occasionally depending on the content.
Capacitor supports this through the
npm install cordova-plugin-screen-orientation npx cap update
Then, use the
unlock methods available on
window.screen.orientation.lock('portrait'); window.screen.orientation.lock('landscape'); // To unlock orientation which will default back to the global setting: window.screen.orientation.unlock();
See the Orientation Plugin Docs for the full range of possible orientation values and configuration options.