auFormSelect

From auWiki
Revision as of 12:20, 12 May 2008 by Misterhaan (talk | contribs) (→‎new auFormSelect)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The auFormSelect class is part of the auLib package. It is defined in the auForm.php file.

Hierarchy

Usage

This class is used to add a one-value selection field to a form. Create an object from this class and add it to an auFormContainer object.

Public Functions

new auFormSelect

new auFormSelect($name, $label, $tooltip, $required, $values, $default, $type)

Creates a one-value selection field.

  • $name = Name to submit the field as.
  • $label = Label to display with the field. Default is blank.
  • $tooltip = Tooltip text to display when the mouse is over the label. Default is none.
  • $required = Whether a value is required in this field. Default is not required.
  • $values = Associative array of possible values (value => display text). If values and display text are all identical, a normal array can be passed through auFormSelect::ArrayIndex($array) to get it into the appropriate format. Default is no possible values.
  • $default = Default value for this field. Default is browser default, which is usually the first of the possible values.
  • $type = Type of field -- set to _AU_FORM_SELECT_RADIO to use radio buttons. Default is _AU_FORM_SELECT_DROPDOWN for a dropdown selection.

ArrayIndex

ArrayIndex($array)

Translates a normal array into an associative array for use in the values parameter of the auFormSelect constructor. This is a static function.

  • $array = Normal array to translate.
  • @return = Array translated into associative form.