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.
| Name | Description | Default Value |
|---|---|---|
| show | Show this ButtonBar. | N/A |
| hide | Hide this ButtonBar. | N/A |
Parameters
Items listed in this section indicate parameters, or attributes which can be set.
| Name | Possible Values | Description | Default 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 Version | 1.8.0 or above |
|---|---|
| Supported Devices | All Android devices. |
| Minimum Requirements | None. |
| Persistence | Persistent - 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>