Hourglass

Enterprise Browser 4.0

Overview

The Hourglass Module is used to show or hide the hourglass (wait cursor) as well as adjust its position.

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.