1 <?php
 2 /**
 3  * Grouped dropdown, using <optgroup> tags.
 4  * 
 5  * $source parameter (from DropdownField) must be a two dimensional array.
 6  * The first level of the array is used for the <optgroup>, and the second
 7  * level are the <options> for each group.
 8  * 
 9  * Returns a <select> tag containing all the appropriate <option> tags, with
10  * <optgroup> tags around the <option> tags as required.
11  * 
12  * @package forms
13  * @subpackage fields-basic
14  */
15 class GroupedDropdownField extends DropdownField {
16 
17     function Field() {
18         // Initialisations
19         $options = '';
20         $classAttr = '';
21 
22         if($extraClass = trim($this->extraClass())) {
23             $classAttr = "class=\"$extraClass\"";
24         }
25         
26         foreach($this->getSource() as $value => $title) {
27             if(is_array($title)) {
28                 $options .= "<optgroup label=\"$value\">";
29                 foreach($title as $value2 => $title2) {
30                     $selected = $value2 == $this->value ? " selected=\"selected\"" : "";
31                     $options .= "<option$selected value=\"$value2\">$title2</option>";
32                 }
33                 $options .= "</optgroup>";
34             } else { // Fall back to the standard dropdown field
35                 $selected = $value == $this->value ? " selected=\"selected\"" : "";
36                 $options .= "<option$selected value=\"$value\">$title</option>";
37             }
38         }
39 
40         $id = $this->id();
41 
42         return "<select $classAttr name=\"$this->name\" id=\"$id\">$options</select>";
43     }
44 }
45 
46 ?>