home program overview dashboard contest dev forum

where » create » reference » cmd

<cmd>

---

The cmd element defines a single soft key command component. The vertical positioning of the text within a soft key command will always resolve to the middle of the height of the footer. The horizontal position of the text within a soft key command will be determined by the largest text in the cmd.

Example

<cmd onSelect="alert( 'soft key press' )">Right</cmd>

Valid Elements

tag	Valid Occurrences
CDATA	0 - 1

Element Specific Attributes

none

Style Attributes

bg, bgfocus, bgfocusimg, bgimg, border, bordercolor, borderfocus, fg, fgfocus, fontsize, fontstyle, style

Action Attributes

onselect

Common Attributes

id

Tips and Tricks

CDATA Entities &br; and &nbsp; are ignored in the CDATA portion of the cmd.

While only two cmd elements are permitted in the footer, its possible to "trick" the user into seeing a center soft key. The following code will display a center soft key:

<footer bg="0x0000FF">
      <cmd>|                                      Right</cmd>
      <cmd>Left                            Center</cmd>
</footer>

Note: You will need to experiment with the spacing of the keys for different screen widths. You will also need to call addTrigger() to associate with the Center soft key.