Input

__input command specifies a text entry.

__input "name='variable' value='value' title='label' 
         type='type' format='mask' emptyok='boolean' 
         size='n' maxlength='n' tabindex='n'"

'name' attribute specifies the variable name that stores the user's input. It is a required attribute. 'value' attribute is the default value of the name attribute. If name variable had a value then 'value' attribue is ignored. If the value does not conform to the mask of the format attribute, the value attribute is ignored. 'type' attribute may be text or password. And the default value is text. password value will hide the input characters. 'title' attribute specifies a title.

'format' attribute specifies an input mask. Its control string specifies the format that is legal to input. The default format is *M which allows any characters. 'A' is for uppercase non-numeric character; 'a' is for 'lowercase non-numeric character; 'N' is for numeric character; 'X' is for any uppercase character; 'M' is for any character and suppose the input is a uppercase character; 'm' is for any character and suppose the input is a lowercase character. In the following format, f is one of above character. '*f' is for any number of f characters. 'nf' is for n characters where n is a number from 1 to 9. '\c' diplays the next character in the entry field.

If 'emptyok' attribute is true, the __input command accepts empty input although the there is a format string. Its default value is false. 'size' attribute specifies the width of the input field in the number of characters. 'maxlength' attribute specifies the maximum number of characters of the field. 'tabindex' attribute specifies the tab position of the text.

_card
  quote "Login:"


  __input "type='text' name='login'"
  quote "Password"
  __input "type='password' name='password'"
card_	

_select command lets user choose from a list of options. The content of a _select may be _optgroup or _option commands.

_select "title='label' multiple='boolean' name='variable' 
         value='default' iname='number' ivalue='default' tabindex='n'"
  optgroup +
  option +
select_

'title' attribute specifies a title. If the value of 'multiple' attribute is true, _select command will accept multiple selections. Its default value is false. 'name' attribute represents the name of a variable. 'value' attribute sets the default value of the variable in the 'name' attribute. For multiple options, the value atrribute may be set by a list of selected values, separated by semicolons.

'iname' attribute is the variable name with an index number. The index number set the default option. An zero index number specifies that there is no item selected. Index number starts from 1. 'ivalue' attribute specifies the default option. When there is no iname attribute, the value of ivalue is displayed for the card. 'tabindex' attribute specifies the position of current item.

_option command a single option for _select command.

_option "title='label' value='value' onpick='href'"
  onevent *
option_	

'title' attribute is the title of the _option. 'value' attribute specifies the value of selection. When a user selects this option in the single-selection mode, 'onpick' event is activated and switch to its href. When it is in the multiple-selection mode, whenever a user enables or disables this selection, it will generate a onpick event.

_optgroup collects related _option commands into a group. It can be used to generate a hierarchical options.

_optgroup "title='label' xml:lang='lang'"
  (optgroup|option) +
optgroup_	

Except the common attributes, 'title' attribute specifies title of _optgroup command. The 'xml:lang' attribute specifies the language.

_fieldset command groups related fields and text. _fieldset command may be nested.

_fieldset "title='label'"
  input *
  select *
  fieldset *
  a *
  img *
  tab *
  br *
  (em|strong|b|i|u|big|small) *
fieldset_	

'title' attribute specifies its title.