Details

ComboSelectField

 ComboSelectField (String fieldName, Array options, 
        String selectedOption {optional}, Array values {optional}, Object selectedValue {optional})

• fieldName - The name and id of the select field
• options - an Array of the select field's options ¹
• selectedOption - a String representing the option in the options array which is to be selected initially.
• values - an Array of the values to be used for the supplied options.
• selectedValue - the value in the values array which should be selected initially.

ListSelectField

 FormSelectFieldPresentation ListSelectField (String fieldName, Integer size, Object multiple, Array options, 
        String selectedOption {optional}, Array values {optional}, Object selectedValue {optional})

• fieldName - The name and id of the select field
• size - the number of rows to display.
• multiple - a Boolean indicating whether multiple selections can be made. This is 'False' by default.
• options - an Array of the select field's options ¹
• selectedOption - a String representing the option in the options array which is to be selected initially.
• values - an Array of the values to be used for the supplied options.
• selectedValue - the value in the values array which should be selected initially.

¹ In HTML terms a combo/listbox is a select element, which contains option elements. E.g.

 <select name="test" id="test">
   <option value="1">one</option>
   <option value="2">selected="selected">two</option>
   <option value="3">three</option>
 </select>

Example

To produce the output in ¹ (a combo-box) above would require the following:

 @@Presentations.ComboSelectField("test", ["one", "two", "three"], null, [1, 2, 3], 2)@@

To produce a similar multi-select listbox would require the following:

 @@Presentations.ListSelectField("test", 2, true, ["one", "two", "three"], null, [1, 2, 3], 2)@@

Practical Example

This example shows how to create a combo-box that contains the version history for the current topic:

 :TopicHistory:{
        topic.Changes.Collect{ each | each.Version }
 }
 @@[Presentations.FormStart(federation.LinkMaker.LinkToTopic(topic.Fullname), "get"),
 "History: ",
 Presentations.ComboSelectField("version", TopicHistory()), " ",
 Presentations.ImageButton("goButton", federation.LinkMaker.LinkToImage("images/go-dark.gif"), "Submit"),
 Presentations.FormEnd()]@@

Notes

If a values parameter is supplied, then the selectedValue parameter will be used to select the initial value; otherwise the selectedOption parameter is used to determine the initial selection.