Platform

The Platform service can be used to get information about your current device.
You can get all of the platforms associated with the device using the platforms
method, including whether the app is being viewed from a tablet, if it's
on a mobile device or browser, and the exact platform (iOS, Android, etc).
You can also get the orientation of the device, if it uses right-to-left
language direction, and much much more. With this information you can completely
customize your app to fit any device.

Depending on the platform the user is on, is(platformName) will
return true or false. Note that the same app can return true
for more than one platform name. For example, an app running from
an iPad would return true for the platform names: mobile,
ios, ipad, and tablet. Additionally, if the app was running
from Cordova then cordova would be true, and if it was running
from a web browser on the iPad then mobileweb would be true.

The pause event emits when the native platform puts the application
into the background, typically when the user switches to a different
application. This event would emit when a Cordova app is put into
the background, however, it would not fire on a standard web browser.

Returns a promise when the platform is ready and native functionality
can be called. If the app is running from within a web browser, then
the promise will resolve when the DOM is ready. When the app is running
from an application engine such as Cordova, then the promise will
resolve when Cordova triggers the deviceready event.

The resolved value is the readySource, which states which platform
ready was used. For example, when Cordova is ready, the resolved ready
source is cordova. The default ready source value will be dom. The
readySource is useful if different logic should run depending on the
platform the app is running from. For example, only Cordova can execute
the status bar plugin, so the web should not run status bar plugin logic.

The back button event is triggered when the user presses the native
platform’s back button, also referred to as the “hardware” back button.
This event is only used within Cordova apps running on Android and
Windows platforms. This event is not fired on iOS since iOS doesn’t come
with a hardware back button in the same sense an Android or Windows device
does.

Registering a hardware back button action and setting a priority allows
apps to control which action should be called when the hardware back
button is pressed. This method decides which of the registered back button
actions has the highest priority and should be called.

Param

Type

Details

fn

Function

Called when the back button is pressed,
if this registered action has the highest priority.

priority

number

Set the priority for this action. Only the highest priority will execute. Defaults to 0.

The resize event emits when the native platform pulls the application
out from the background. This event would emit when a Cordova app comes
out from the background, however, it would not fire on a standard web browser.

The resume event emits when the native platform pulls the application
out from the background. This event would emit when a Cordova app comes
out from the background, however, it would not fire on a standard web browser.

Set the app’s language direction, which will update the dir attribute
on the app’s root <html> element. We recommend the app’s index.html
file already has the correct dir attribute value set, such as
<htmldir="ltr"> or <htmldir="rtl">. This method is useful if the
direction needs to be dynamically changed per user/session.
W3C: Structural markup and right-to-left text in HTML

Set the app’s language and optionally the country code, which will update
the lang attribute on the app’s root <html> element.
We recommend the app’s index.html file already has the correct lang
attribute value set, such as <htmllang="en">. This method is useful if
the language needs to be dynamically changed per user/session.
W3C: Declaring language in HTML