META tags

META tags are included at the top of a web page within the <head> and </head> tags. Some Web hosts have specific META tags built in to the page that the Velocity Client can use. These are configured on the host and not in the Velocity Console or Client.

They are evaluated in the order they appear in the web page (from top to bottom). Velocity ignores tags it does not recognize.

Each META tag has the following format:

<meta http-equiv="[action_name]">

The action_type can be a URL, an IDA action, a JavaScript function, or a script. For example:

<meta http-equiv="OnStartup">

The following META tags are supported by the Velocity Client.

The OnKey and OnKey0x META tags describe an action that will occur if a particular key is pressed. The key values evaluated are the same key values used by the Velocity Console. The OnKey0x format requires a unicode value and the OnKey format requires a decimal format. The key value is case sensitive.

For example:

OnKey50 and OnKey0x32 respond when the user presses 2.

OnKey65 and OnKey97 respond to both the upper and lowercase A.

The OnAllKeys tag will perform the specified action each time any key is pressed. The action type can include one argument, which is the string representing the decimal value of the key.

The OnStartup or OnLoaded META tags allow you to specify actions that will be taken when the web page is first loaded. OnLoaded will not be called until the page has completely loaded. There are situations where OnStartup will be called before the page is completely loaded, so images, stylesheets or JavaScript files may not be available. So, for example, if OnStartup is calling a JavaScript function referenced by the web page, the call may fail. In that case, use OnLoaded to make sure that the .js file functions are available.

An example of this tag in use is provided below.

<html>

<head>

<Title>META Tag Onloaded Example</Title>

<META http-equiv="OnLoaded" content="Javascript:helloWorld();">

<script>

function helloWorld()

{

alert("Hello world!");

}

</script>

</head>

<body>

<h1>Onloaded Example</h1>

<p>This is a sample test page.</p>

</body>

</html>

In this example, the function helloWorld() is called to display an alert on the device when the screen is fully loaded.

This section includes tags that enable or disable the scanner.

If the action attribute is set to Scanner and the content is Enable, the scanner will be enabled when the page is first loaded. If the content is Disable , the scanner will be disabled when the page is first loaded.

For example: 

<meta http-equiv="Scanner" content="Disable">

The scanner action types supported by the Velocity Client include:

•ScannerNavigate

•ScannerProcessed

When you call a script from a meta tag, specify the action in the http-equiv attribute and then provide the name of the script in the content attribute. For example:

<meta http-equiv="OnStartup" content="wls:WebAuto(1000,'5','1')">

-Or-

<meta http-equiv="OnStartup" content="wls:WebAuto">

Just a reminder: when you pass numbers in as parameters, they do not need quotation marks. When you pass text or strings in as parameters, you must use quotation marks.

If you cannot modify your host directly, you can use insert APIs to insert HTML, CSS, and JavaScript on the page.

For more information about using scripts, see Using Advanced Configuration.