JIN Reference
Parent Elements
| Start tag |
Purpose |
JIN |
| <body> |
Defines the portion of a JIN page that is diplayed on a handset's screen |
2.0 |
| <footer> |
The portion of the body that spans the bottom-most region of the screen |
2.0 |
| <form> |
Represents a submit-able HTTP request |
2.0 |
| <header> |
The portion of the body that spans the top-most region of the screen |
2.0 |
| <jin> |
Indicates the start of a JIN document and the outer-most element |
2.0 |
| <layer> |
Defines a window which overlays the main screen |
2.0 |
| <pop> |
Defines a pop-up window which overlays the main screen |
2.0 |
| <pr> |
Defines a page row in a JIN page |
2.0 |
| <script> |
Defines the start of the scripting portion of a JIN page |
2.0 |
| <stylesheet> |
Defines a loadable set of styles which are saved to non-volatile memory |
2.0 |
Display Elements
| Start tag |
Purpose |
JIN |
| <choice> |
Defines a vertically aligned choice group of check boxes or radio buttons |
2.0 |
| <cmd> |
Defines a single soft key command component |
2.0 |
| <dynimg> |
Defines an img element that can optionally change to another img element when it gains focus |
2.0 |
| <img> |
Defines an image component with optional text that overlays the image |
2.0 |
| <input> |
Defines a set of components that accept user input such as user entered text or button clicks |
2.0 |
| <list> |
Defines a selectable list of horizontally aligned items |
2.0 |
| <listitem> |
Defines a single list item in a list |
2.0 |
| <ln> |
creates a visual line on the screen |
2.0 |
| <map> |
Defines an image that the user can pan and zoom |
2.0 |
| <option> |
Defines a drop-down option list component |
2.0 |
| <selected> |
Defines selected or focused portion of some outer tag |
2.0 |
| <text> |
Defines text to be displayed |
2.0 |
Style Attributes
| Attribute |
Purpose |
Values |
Default |
JIN |
| align |
horizontal alignment of a component |
left, center, right |
left |
2.0 |
| bg |
background color |
0x00000 to 0xFFFFFF |
0xFFFFFF |
2.0 |
| bgfocus |
background color of a focused component |
0x00000 to 0xFFFFFF |
bg attribute |
2.0 |
| bgfocusimg |
background image of a focused component |
valid URL of an image |
bgimg attribute |
2.0 |
| bgimg |
background image of a component |
valid URL of an image |
none |
2.0 |
| border |
specifies whether to display border |
0 or 1 |
0 |
2.0 |
| bordercolor |
border color of a component if border is present (border=1) |
0x000000 to 0xFFFFFF |
0x000000 |
2.0 |
| borderfocus |
border color of a focused component if border is present (border=1) |
0x000000 to 0xFFFFFF |
bordercolor attribute |
2.0 |
| fg |
foreground color of a component |
0x000000 to 0xFFFFFF |
0x000000 |
2.0 |
| fgfocus |
foreground color of a focused component |
0x000000 to 0xFFFFFF |
fg attribute |
2.0 |
| fontsize |
font size of text |
small, medium, large |
medium |
2.0 |
| fontstyle |
font style of text |
bold, italic, plain, underlined |
plain |
2.0 |
| valign |
vertical alignment of a component |
top, center, bottom |
top |
2.0 |
Common Attributes
| Attribute |
Purpose |
Values |
Default |
JIN |
| colspan |
Forces this tag to occupy the specified number of columns |
1 - * |
1 |
2.0 |
| id |
Identifies this element and gives the developer the ability to later reference this object in the script directly |
CDATA |
none |
2.0 |
Action Attributes
| Attribute |
Purpose |
JIN |
| onfocus |
Define the script that gets called when this component gains focus. Not all display elements can accept focus |
2.0 |
| onselect |
Define the script that gets called when this component gets selected |
2.0 |
| onload |
Define the script that gets called once the page has loaded. This action attribute is only valid in <body> tag |
2.0 |
| onexit |
Define the script that gets called when user leaves this JIN page. This action attribute is only valid in <body> tag |
2.0 |
JIN Entities
| Entity |
Purpose |
JIN |
| |
Non-breaking space |
2.0 |
| &br; |
Line break |
2.0 |
Global Variables
WHERE makes certain values available to every widget. These are available in the request data sent to the widget. For more info see the
FAQ.
| Parameter Name |
Description |
Data Type |
| lat |
the user's current latitude |
decimal |
| lng |
the user's current longitude |
decimal |
| deviceid |
the unique id of the device the user registered with |
integer |
| carrier |
the name of the phone carrier the user registered with |
string |
| device |
the manufacturer and model of the device the user registered with |
string |
| screenwidth |
the screen width of the device the user registered with |
integer |
Scripting