Property Reference

Top  Previous  Next

 

Properties can be divided in two groups: matching properties and applying properties.

 

Matching properties are those used to test the browser and device properties (such as the browser user agent, the device pixel ratio, the display orientation width and height, etc.) in order to choose the best model for each case.

 

match-device-pixel-ratio

Matches any device with a specific pixel ratio.

match-mobile

Matches any mobile device.

match-orientation

Matches any device with the specified orientation: landscape or portrait.

match-screen-height-range

 

Matches any device with a screen height in the specified range. This range is expressed as From-To (for example, 900-1200).

match-screen-width-range

Matches any device with a screen width in the specified range. This range is expressed as From-To (for example, 400-600).

match-screen-height

Matches any device with a specified screen height.

match-screen-width

Matches any device with a specified screen width.

match-user-agent

Matches devices by comparing the device browser user agent to the string value supplied. This string is a regular expression.

 

Applying properties are those used to determine the final size and resolution.

 

Use the parent-model property to set the parent model:

 

parent-model

Establish the parent model for this model.

 

The following properties deal with the display resolution:

 

device-pixel-ratio

Overrides the original device pixel ratio, scaling the content accordingly.

max-device-pixel-ratio

This property determines the maximum device pixel ratio accepted. The lesser of the device’s device pixel ratio and this value is applied to scale the display.

 

The following properties deal with the screen size of the remote desktop, in pixels. You can determine it by setting the actual height and width, or by establishing maximum and minimum values for these properties.

 

height

Remote desktop height.

width

Remote desktop width.

max-height

Remote desktop maximum height.

max-width

Remote desktop maximum width.

min-height

Remote desktop minimum height.

min-width

Remote desktop minimum width.

 

The following properties allow you to specify device screen areas that will never be used for displaying the remote connection, such as when a browser or device bar cannot be hidden and uses up screen space. These margins will be excluded for screen size calculations.

 

margin-left

Width of an area at the left of the device screen that will not be used for displaying the remote desktop.

margin-bottom

Width of an area at the bottom of the device screen that will not be used for displaying the connection.

margin-right

Width of an area at the right of the device screen that will not be used for displaying the connection.

margin-top

Width of an area at the top of the device screen that will not be used for displaying the connection.

 

Miscellaneous properties:

 

use-full-screen

For mobile only. If the device’s browser supports the full-screen mode, this property indicates the remote desktop size should be calculated to occupy the whole screen. When not in full screen, the content will be scaled.

 

Read More:

The Calculation Process
Examples