HAWHAW XML ReferenceVersion 1.9


<deck>


Down  Summary
Down  Attributes
Down  Examples
Down  See also

Summary
The <deck> element is nested inside the <hawhaw> element. Each HAWHAW XML file must contain exactly one <deck> element. The term "deck" comes from the WAP terminology. Using HAWHAW you can consider a deck as a small web page, which contains the content you have declared in the HAWHAW XML file.
A lot of attributes allow to control the appearance of the <deck> element on various browsers and devices.
The markup language and the HTTP response headers created by HAWHAW are depending from the detected browser/device. For WML browsers one deck with one card will be generated. For HDML browsers one deck including as much cards as necessary will be generated. HTML browsers will receive a normal HTML page. PDA browsers will receive handheldfriendly HTML etc.
Do not overload HAWHAW decks because a lot of WAP clients can not handle more than about 1400 byte of compiled data.
 
Attributes
title (optional) - The title will be displayed in the HTML title bar, respectively somewhere on a WAP display. Using a title you will normally have to spend one of your few lines on your WAP display. Consider that some WAP phones/SDK's and handheld devices don't display the title at all!
align left (default) | center | right
The align attribute controls the alignment of the whole deck.
output automatic (default) | bigscreen | wap | hdml | pda | imode | mml | voicexml | xhtml
You can override HAWHAW's automatic browser detection and force a certain output type. With this attribute you can offer dedicated links for PC's, WAP phones, PDA's, XHTML phones etc.
redirection (optional) - Causes redirection after specified seconds to another URL.
Redirection is not necessarily supported by all device. It is always a good idea to declare an additional link in case the automatic redirection does fail.
Add an additional ";proxy=no" parameter in case that the URL is not to be retrieved via the HAWHAW proxy.
cache yes (default) | no
Disables deck caching in the users client.
Note: Use this attribute, if you intend to provide changing content under the same URL.
charset Sets a given charset (default: utf-8, until hawhaw.inc V5.19: iso-8859-1)
skin (optional) - none | classic | <css-url>
<css-url>: Replaces the proxy-provided default skin with a user-defined skin, which has to be defined in a CSS file that is addressed by the skin attribute.
See CSS file of HAWHAW default skin for more info.
Usage of the skin attribute can be blocked per configuration by proxy provider.
css (optional) - Sets a css file for css-enabled browsers.
css_class (optional) - sets a css class for this element.
background (optional) - Sets a window wallpaper for a HTML (big-screen browser) page.
bgcolor (optional) - Sets a window background color for a HTML (big-screen browser) page. Has no effect on WML/handheld pages. See HTML specification for possible values (e.g. "#CCFFFF", "red", ...).
size (optional) - Sets the font size for all characters in a (X)HTML created page. Has no effect on WML/handheld pages. See HTML specification for possible values (e.g. "12pt", ...).
color (optional) - Sets the color for all characters in a (X)HTML created page. Has no effect on WML/handheld pages. Nevertheless, <text> elements can overwrite this attribute by defining their own color attributes. See HTML specification for possible values (e.g. "#CCFFFF", "red", ...).
link_color (optional) - Sets the color of links in a (X)HTML created page. Has no effect on WML/handheld pages. See HTML specification for possible values (e.g. "#CCFFFF", "red", ...).
vlink_color (optional) - Sets the color of visited links in a (X)HTML created page. Has no effect on WML/handheld pages. See HTML specification for possible values (e.g. "#CCFFFF", "red", ...).
link_brackets yes (default) | no
Defines whether links are shown within square brackets or not.
face (optional) - Sets the font for all characters in a (X)HTML created page. Has no effect on WML/handheld pages. See HTML specification for possible values (e.g. "Avalon", "Wide Latin", ...).
language (optional) - Sets a given language.
Note: Specifies the main language of the deck, as e.g. english, german, japanese or whatever. Language declaration is highly recommended in order to provide barrierfree content and as is required to validate a deck as Bobby AAA approved!
The language code is to be specified according ISO 639, e.g. "en", "de", etc.
waphome (optional) - Sets the URL of a WAP site, a HTML-browsing user is invited to enter wireless. Has no effect on WML/handheld created pages.
Note: Below the display of a HTML-created page, a small copyright link to the HAWHAW information page will be created automatically by HAWHAW. The information page in return invites the visitor to take a look via WAP at your hybrid page. Therefore by default your hostname and your refering script will be part of this copyright link. You can modify this value, e.g. if your application directs the user with get-method queries across different pages, but you want to make visible the entry page only.
voice_jingle (optional) - Play jingle before <a> link labels are spoken.
Note: Voice users can not distinguish between plain text and link text. Playing a short jingle before each link will make voice navigation easier.
Example: voice_jingle="http://www.foo.com/jingle.wav"
 
Examples

<?xml version="1.0"?> <hawhaw> <deck title="Welcome!" align="center"> <text>Welcome to our new WAP site!</text> </deck> </hawhaw> ... <deck title="Intro" redirection="10; URL=http://wap.foo.com/menu.xml"> ... <deck title="News" cache="no"> ... <deck skin="http://foo.com/my_personal_simulator_skin.css"> ... <deck background="wall.gif" size="10pt" color="green"> ... <deck title="Deck 4711" waphome="http://wap.foo.com/"> ...
 
See also
<hawhaw> <text> <img> <a> <linkset> <form> <hr> <phone> <table> <raw> <voice_text> <voice_help> <voice_nomatch> <voice_noinput>
 
last update: 27.07.2008HAWHAW - Keep on laughing!