ButtonBar20 Module

RhoElements 2.x API

Overview

The ButtonBar20 Module is used to show/hide a particular ButtonBar. To control the size, position, actions and other button attributes, see the ButtonBar Usage guide.

Syntax

buttonBar20 (Module) <META> Syntax

<META HTTP-Equiv="ButtonBar20" content="[parameter]">

ButtonBar20 JavaScript Object Syntax:
By default the JavaScript Object 'buttonBar20' will exist on the current page and can be used to interact directly with the buttonBar20.
To Invoke ButtonBar20 methods via JavaScript use the following syntax: ButtonBar20.method();

e.g. buttonBar20.show();

e.g. buttonBar20.hide();

Methods

Items listed in this section indicate methods or, in some cases, indicate parameters which will be retrieved.

NameDescriptionDefault Value
showShow this ButtonBar.N/A
hideHide this ButtonBar.N/A

Parameters

Items listed in this section indicate parameters, or attributes which can be set.

NamePossible ValuesDescriptionDefault Value
visibility:[Value] 'visible' or 'hidden'Sets the visibility of the button Bar.Hidden.

Remarks

Screen Orientation

When the screen orientation changes, either using the ScreenOrientation tag or by rotating a device with hardware support the buttons themselves are not moved and in some cases this may result in them being off the screen or not in the expected position. If so one has to create and show a different ButtonBar with different coordinates to fit in particular screen orienetation mode(Portrait or Landscape) by detecting the ScreenOrientationEvent.

Requirements

EnterpriseBrowser Version1.8.0 or above
Supported DevicesAll Android devices.
Minimum RequirementsNone.
PersistencePersistent - Changes to this module will persist when navigating to a new page.

HTML/JavaScript Examples

The following example demonstrates how to show the buttonBar via injecting metatag in a page.

<META HTTP-Equiv="ButtonBar20" Content="Visibility:Visible">
<META HTTP-Equiv="ButtonBar20" Content="Visibility:Hidden">

Alternatively you can also show a particular ButtonBar on all pages of your application using DefaultMetaTags tag in Config.xml without changing your server application code. Please include the following in the DefaultMetaTags section in Config.xml.

<DefaultMetaTags>
    <MetaTag value="ButtonBar20~visibility:visible;"/>
</DefaultMetaTags>

The following example demonstrates how to show/hide the ButtonBar via JavaScriptable objects.

<script>
    function showbuttonbar()
    {
        buttonBar20.show();
    }

    function hidebuttonbar()
    {
        buttonBar20.hide();
    }
</script>