Hourglass

RhoElements 2.x API

Overview

The Hourglass Module controls display and position of the hourglass icon, which appears to indicate that a page is loading.

Enabling the API

In order to use this API you must include reference to the following JavaScript file that is included with the Enterprise Browser installation:

  • elements.js

Note - this file either needs to be on the device in a relative folder from where your HTML page is, or it must be copied to your web server appropriately.


<script type="text/javascript" charset="utf-8" src="elements.js"></script>;

API Usage

This API does not use the EB namespace. It is simply referenced using the API name:


hourglass.visibility = 'visible';

Properties

visibility

Type

STRING

Description

Shows or hides the hourglass.

Possible Value

  • visible
  • hidden

Platforms

  • Android
  • Windows Mobile/CE

left

Type

INTEGER - Positive number, representing pixels

Description

Sets the horizontal position of the hourglass.

Possible Values

  • Horizontal position, in pixels - Default = center of screen

Platforms

  • Android
  • Windows Mobile/CE

top

Type

INTEGER - Positive number, representing pixels

Description

Sets the vertical position of the hourglass.

Possible Values

  • Vertical position, in pixels - Default = center of screen

Platforms

  • Android
  • Windows Mobile/CE

Remarks

When navigating between pages the hourglass will be shown and hidden automatically and will override the current visibility settings. The position the hourglass is shown at during page loads will be as set using the Left / Top properties. Because the Hourglass is shown and hidden automatically during page loads it is not recommended to use static meta tags to show or hide it, in preference use InvokeMETATag from JavaScript.

Scrolling

The hourglass is not compatible with scrolling the browser window. The spinning cursor will move with the HTML page.