APEX - PWA Screen Orientation
February 21, 2023 APEX No Comments

When building a Progressive Web Application (PWA) in Oracle Application Express (APEX), there are several orientation settings that you can configure to control how the application is displayed on a mobile device. APEX – PWA screen orientation settings determine the default orientation and supported orientations for the PWA.

You can edit PWA Screen Orientation setting using following steps:

Edit Application Definition -> Progressive Web App -> Screen Orientation

The preferred screen orientation when using this Progressive Web App. This applies mostly for mobile devices.

Note: Some devices and browsers ignore this attribute. Oracle APEX is only relaying this information to the device which handles the Progressive Web App appropriately.

Caution: Please note that I could not find the details of each setting within Oracle APEX Documentation and on Google Search therefore I have used #ChatGPT.

Feel free to comment below if you find details of each setting within Oracle APEX Documentation.

Browser Support:

The orientation setting determines your PWA’s preferred launch layout. The setting has following options:

  • Any
  • Natural
  • Landscape
  • Landscape Secondary
  • Portrait
  • Landscape Primary
  • Portrait Primary
  • Portrait Secondary

Following table shows which combinations of operating system and browser support it:

APEX - PWA Screen Orientation

Explanation of Oracle APEX PWA Screen Orientation Setting are following:

  • Any: The “Any” orientation setting means that the PWA can be displayed in any orientation, whether it is portrait or landscape. This is the default orientation setting for a new PWA in Oracle APEX.

  • Natural: The “Natural” orientation setting means that the PWA will default to the natural orientation of the device. For example, if the device is held in portrait mode, the PWA will be displayed in portrait mode.

  • Landscape: The “Landscape” orientation setting means that the PWA will default to landscape mode.

  • Landscape Primary: The “Landscape Primary” orientation setting means that the PWA will default to landscape mode with the primary landscape orientation. This is basically the landscape orientation where the device’s home button is located.

  • Landscape Secondary: The “Landscape Secondary” orientation setting means that the PWA will default to landscape mode with the secondary landscape orientation. This is basically the landscape orientation where the device’s volume buttons are located.

  • Portrait: The “Portrait” orientation setting means that the PWA will default to portrait mode.

  • Portrait Primary: The “Portrait Primary” orientation setting means that the PWA will default to portrait mode with the primary portrait orientation. This is basically the portrait orientation where the device’s home button is located.

  • Portrait Secondary: The “Portrait Secondary” orientation setting means that the PWA will default to portrait mode with the secondary portrait orientation. This is basically the portrait orientation where the device’s volume buttons are located.

In conclusion, by configuring these orientation settings in Oracle APEX, you can optimize your PWA for the user’s preferred viewing experience.

Thanks to #ChatGPT 🙂

References:

You can read more information on following links:

Written by Sohilkumar Bhavsar
Cloud Architect at Zero Integration Ltd. 14+ years of experience with Oracle, Linux, Networking, Data Centre and Public Clouds. Played major role in development, implementation and management of SaaS CRM using AI and ML. Integrated 15+ Client CRM across United Kingdom and Australia.