Class SelectWidget

Defined in widgetsBasic.js

SelectWidget is a wrapper around the <select> widget, because it is a pain to deal with in .content specifications.

Terminology note: I refer to what the user sees on the screen as the human choice, and what the widget returns as the value as the computer choice. For example, with <option value='#FF0000'>red</option>, the human value is "red", but the computer value is "#FF0000".

Relevant Parameters:

• values: An array of possible <options>. Each option should be in the order it will appear on the screen, and may be one of two things:
  1. A string which is both the human value, and the computer value if that is the current choice.
  2. A Javascript array, where the first value is the computer value, and the second is the human value. For instance, if I was offering the user a choice of "Michigan" which I wanted to have the postal abbrevation of "MI" for, I'd put ["MI", "Michigan"] as the value.
  This may be reset but if it is, it will blow away any other options that used to be available.
• value: Read/write the current computer value of the widget. (The select widget inherits this, so behavior if the written value is not in the select widget will be browser-defined.)

Inheritances:

The <select> DOM node inherits everything ("*").

Constructor Detail

SelectWidget

SelectWidget()

SelectWidget - a wrap around <select>

addOption

void addOption(computerValue, humanValue)

Adds a single option to the end of the widget.

Parameters:
computerValue - The value that will be used as the computer value for the choice.
humanValue - The value the human will see. If not given, the computer value will be used instead.

empty

void empty()

empty - remove all choices from the widget