📺 "One project. One language. Three apps." Learn more in our upcoming code sharing webinar!

NativeScript Core

Supporting Multiple Screens

Mobile application run on different devices with different screen sizes and form factors. NativeScript provides a way to define different files(.js, .css, .xml etc.) to be loaded based on the screens size, platform and orientation of the current device. The approach is somewhat similar to multi screen support in android. There is a set of qualifiers that can be added inside the file that will be respected when the file is loaded. Here is how the file should look like:

<file-name>[.<qualifier>]*.<extension>

NativeScript supports three different file qualifiers:

  • Platform qualifiers
  • Screen size qualifiers
  • Orientation qualifiers

Important: The qualifiers for screen size and orientation are supported only in NativeScript Core applications. These qualifiers are not compatible with Angular and Webpack builds. The platform qualifiers can be used in both NativeScript Core and NativeScript Angular applicaitons (with or without Webpack).

Platform Qualifiers

  • android – android platform
  • ios – iOS platform

Example(platform specific files):

  • app.android.css - CSS styles for Android.
  • app.ios.css - CSS styles for iOS.

The platform qualifiers are executed during build time, while the others - during run time. For example, the app.ios.css file will not be taken in consideration when building for android platform. Contrary, the screen size qualifiers will be considered just after the application runs on a device with specific screen size.

Screen Size Qualifiers

All the values in screen size qualifiers are in density independent pixels(dp) - meaning it corresponds to the physical dimensions of the screen. The assumptions is that there are ~160 dp per inch. For example, according to android guidelines if the device's smaller dimension is more than 600dp(~3.75 inches) it is probably tablet.

  • minWH<X> - The smaller dimension(width or height) should be at least X dp.
  • minW<X> - Width should be at least X dp.
  • minH<X> - Height should be at least X dp.

Example(separate XML file for tablet and phone):

  • main-page.minWH600.xml - XML file to be used for tablet devices.
  • main-page.xml - XML to be used for phones

Note: Not supported by Angular and Webpack builds

Orientation Qualifiers

  • land - orientation is in landscape mode
  • port - orientation is in portrait mode

Note: Not supported by Angular and Webpack builds Note: All qualifiers are taken into account when the page is loading. However, changing the device orientation will not trigger page reload and will not change the current page.