Overview
The History Meta Tag is an action tag used to navigate forward or backward through the page history.
Syntax
| history (META Tag) <META> Syntax |
|---|
<META HTTP-Equiv="History" content="Back:1"> |
<META HTTP-Equiv="History-Back" contents="1"> |
| History JavaScript Object Syntax: |
|---|
| By default the JavaScript Object 'history' will exist on the current page and can be used to interact directly with the history. |
|
To Invoke history methods via JavaScript use the following syntax: history.method();
e.g. history.back(); |
|
To Set history parameters via JavaScript use the following syntax: history.parameter = 'value'; remembering to enclose your value in quotes where appropriate.
e.g. history.back = 'value'; |
|
To set multiple EMML parameters / events on a single line use the following syntax: history.setEMML("[Your EMML Tags]");
e.g. history.setEMML("back:valueback"); |
Methods
Items listed in this section indicate methods or, in some cases, indicate parameters which will be retrieved.
| Name | Description | Default Value |
|---|---|---|
| back | Navigates back one page in the browser history. This tag will have no effect if there is no browser history. | N/A |
| forward | Navigates forward one page in the browser history. This tag will have no effect if not predicated by a 'Back' command. | N/A |
Parameters
Items listed in this section indicate parameters, or attributes which can be set.
| Name | Possible Values | Description | Default Value |
|---|---|---|---|
| back:[Value] | Positive Integer specifying the number of pages to navigate back | Navigates back the specified number of pages in the browser history. This tag will have no effect if there is no browser history. | 1. See parameters without attributes section. |
| forward:[Value] | Positive Integer specifying the number of pages to navigate forward | Navigates forward the specified number of pages in the browser history. This tag will have no effect if there is no browser history. | 1. See parameters without attributes section. |
Remarks
Deprecation
This tag deprecates the history:back URL
Requirements
| RhoElements Version | N/A or above |
|---|---|
| Supported Devices | Windows CE, Windows Mobile, Windows Mobile SE |
| Minimum Requirements | RhoElements |
| Persistence | This tag is page specific and is actioned immediately. |
HTML/JavaScript Examples
The following example navigates back one page when the delete key is pressed (regardless of the Accelerate Key mode)
<META HTTP-Equiv="AccelerateKey" Content="OFF">
<META HTTP-Equiv="OnKey0x09" Content="onBackspacePressed">
<script>
function onBackspacePressed()
{
history.back = 1;
}
</script>