Object “device”
Object > NativeObject > Device
Provides information about the device that executes the application.
| Constructor | private |
| Singleton | device |
| Namespace | tabris |
| Direct subclasses | None |
| JSX support | No |
See also:
JSX Reading various device properties
Properties
language
The user language configured on the device as an RFC 4646 compliant string. For example "de", "es-ES", etc. This property is also available globally as navigator.language. Note: On iOS ≥ 11 it will only return languages declared in CFBundleLocalizations.
| Type | string |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
model
The name of the device model. For example "iPad4,1" or "Nexus 7". This property is also available globally as device.model.
| Type | string |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
name
The name of the device set by owner. For example "John's phone". This property is also available globally as device.name.
Note: On Android name is only available on Android 7.1+.
| Type | string |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
orientation
The device orientation. One of portrait-primary, portrait-secondary, landscape-primary, and landscape-secondary.
| Type | 'portrait-primary' | 'portrait-secondary' | 'landscape-primary' | 'landscape-secondary' |
| Settable | No |
| Change events | Yes |
platform
The name of the platform. Either "Android" or "iOS". This property is also available globally as device.platform.
| Type | 'Android' | 'iOS' |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
scaleFactor
The ratio between physical pixels and device independent pixels. This property is also available globally as window.devicePixelRatio.
| Type | number |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
screenHeight
The entire height of the device’s screen in device independent pixel. Depends on the current device orientation. This property is also available globally as screen.height.
| Type | number |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
screenWidth
The entire width of the device’s screen in device independent pixel. Depends on the current device orientation. This property is also available globally as screen.width.
| Type | number |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
vendor
The name of the device manufacture. For example "Samsung" or "Apple". This property is also available globally as device.vendor.
| Type | string |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
version
The platform version. On iOS it looks like this: "8.1.1". On Android, the version code is returned. This property is also available globally as device.version.
| Type | string |
| Settable | No |
| Change events | No |
This property can only be set via constructor. Once set, it cannot change anymore.
Change Events
orientationChanged
Fired when the orientation property has changed and the rotation animation has finished.
| Parameter | Type | Description |
|---|---|---|
| value | string |
The new value of orientation. |
