Usage * * * new OptionsetField( * $name = "Foobar", * $title = "FooBar's optionset", * $source = array( * "1" => "Option 1", * "2" => "Option 2", * "3" => "Option 3", * "4" => "Option 4", * "5" => "Option 5" * ), * $value = "1" * ); * * * You can use the helper functions on data object set to create the source array. eg: * * * //Database request for the object * $myDoSet = DataObject::get("FooBars",""); * if($myDoSet){ * // This returns an array of ID => Title * $map = $myDoSet->toDropDownMap(); * * // Instantiate the OptionsetField * $FieldList = new FieldList( * new OptionsetField( * $name = "Foobar", * $title = "FooBar's optionset", * $source = $map, * $value = $map[0] * ) * ); * } * * // Pass the fields to the form constructor. etc * * * @see CheckboxSetField for multiple selections through checkboxes instead. * @see DropdownField for a simple field with a single element. * @see TreeDropdownField for a rich and customizeable UI that can visualize a tree of selectable elements * * @package forms * @subpackage fields-basic */ class OptionsetField extends DropdownField { protected $template = 'OptionsetField'; /** * @var Array */ protected $disabledItems = array(); function Field($properties = array()) { $source = $this->getSource(); $odd = 0; $options = array(); if($source) { foreach($source as $value => $title) { $itemID = $this->ID() . '_' . preg_replace('/[^a-zA-Z0-9]/', '', $value); $odd = ($odd + 1) % 2; $extraClass = $odd ? 'odd' : 'even'; $extraClass .= ' val' . preg_replace('/[^a-zA-Z0-9\-\_]/', '_', $value); $options[] = new ArrayData(array( 'ID' => $itemID, 'Class' => $extraClass, 'Name' => $this->name, 'Value' => $value, 'Title' => $title, 'isChecked' => $value == $this->value, 'isDisabled' => $this->disabled || in_array($value, $this->disabledItems), )); } } $properties = array_merge($properties, array('Options' => new ArrayList($options))); return $this->customise($properties)->renderWith($this->getTemplate()); } function performReadonlyTransformation() { // Source and values are DataObject sets. $items = $this->getSource(); $field = new LookupField($this->name, $this->title ? $this->title : '', $items, $this->value); $field->setForm($this->form); $field->setReadonly(true); return $field; } /** * Mark certain elements as disabled, * regardless of the {@link setDisabled()} settings. * * @param array $items Collection of array keys, as defined in the $source array */ function setDisabledItems($items) { $this->disabledItems = $items; return $this; } /** * @return Array */ function getDisabledItems() { return $this->disabledItems; } function ExtraOptions() { return new ArrayList(); } }