Once a choice list is displayed, the user can move the mouse over the list, thus highlighting various choices; then click on the highlighted choice to select it. Alternatively, the user can navigate the list with keys DOWN, UP, HOME, END, and then use either RETURN (for selecting) or ESCAPE (for cancelling).

Callback function for generating HTML for the choiceList. This function is called with some pre-built HTML containing all current choices; the wrapper has a chance to modify that HTML for example for adding classes, borders or table headers. Default is the identity function.

HTML tag name for generating a choice entry in the choice list. Default is "div". Set it to "tr" if you want the choice list to be displayed as a table (but then you also have to open and close the table within the htmlWrapper callback).

This method generates HTML from the choice list, and inserts it in the innerHTML of the supplied container; furthermore, it registers a keymap on that container in order to manage navigation from keyboard (DOWN, UP, etc.).

This event is triggered when a choice in the list is "ping-ed", i.e. either by clicking or by pressing the RETURN key. Usually this means "select", but it is up to the event handler to decide how to interpret the event. The event handler may use event.index to know the index of the ping-ed choice.