ionic.Platform

A set of utility methods that can be used to retrieve the device ready state and various other information such as what kind of platform the app is currently installed on.

Usage

angular.module('PlatformApp', ['ionic'])
.controller('PlatformCtrl', function($scope) {

  ionic.Platform.ready(function(){
    // will execute when device is ready, or immediately if the device is already ready.
  });

  var deviceInformation = ionic.Platform.device();

  var isWebView = ionic.Platform.isWebView();
  var isIPad = ionic.Platform.isIPad();
  var isIOS = ionic.Platform.isIOS();
  var isAndroid = ionic.Platform.isAndroid();
  var isWindowsPhone = ionic.Platform.isWindowsPhone();

  var currentPlatform = ionic.Platform.platform();
  var currentPlatformVersion = ionic.Platform.version();

  ionic.Platform.exitApp(); // stops the app
});

Methods

ready(callback)

Trigger a callback once the device is ready, or immediately if the device is already ready. This method can be run from anywhere and does not need to be wrapped by any additonal methods. When the app is within a WebView (Cordova), it’ll fire the callback once the device is ready. If the app is within a web browser, it’ll fire the callback after window.load. Please remember that Cordova features (Camera, FileSystem, etc) still will not work in a web browser.

setGrade(grade)

Set the grade of the device: ‘a’, ‘b’, or ‘c’. ‘a’ is the best (most css features enabled), ‘c’ is the worst. By default, sets the grade depending on the current device.

device()

Return the current device (given by cordova).

• Returns: object The device object.

isWebView()

• Returns: boolean Check if we are running within a WebView (such as Cordova).

isIPad()

• Returns: boolean Whether we are running on iPad.

isIOS()

• Returns: boolean Whether we are running on iOS.

isAndroid()

• Returns: boolean Whether we are running on Android.

isWindowsPhone()

• Returns: boolean Whether we are running on Windows Phone.

isEdge()

• Returns: boolean Whether we are running on MS Edge/Windows 10 (inc. Phone)

platform()

• Returns: string The name of the current platform.

version()

• Returns: number The version of the current device platform.

is(Platform)

• Returns: boolean Whether the platform name provided is detected.

exitApp()

Exit the app.

showStatusBar(shouldShow)

Shows or hides the device status bar (in Cordova). Requires cordova plugin add org.apache.cordova.statusbar

fullScreen([showFullScreen], [showStatusBar])

Sets whether the app is fullscreen or not (in Cordova).

Properties

• boolean isReady

  Whether the device is ready.

• boolean isFullScreen

  Whether the device is fullscreen.

• Array(string) platforms

  An array of all platforms found.

• string grade

  What grade the current platform is.

• string ua

  What User Agent is.