silverstripe-framework/src/Forms/GroupedDropdownField.php

108 lines
2.9 KiB
PHP
Raw Normal View History

<?php
namespace SilverStripe\Forms;
use SilverStripe\ORM\ArrayList;
use SilverStripe\View\ArrayData;
/**
2017-11-14 11:02:24 +01:00
* Grouped dropdown, using optgroup tags.
2014-08-15 08:53:05 +02:00
*
* $source parameter (from DropdownField) must be a two dimensional array.
2017-11-14 11:02:24 +01:00
* The first level of the array is used for the optgroup, and the second
* level are the <options> for each group.
2014-08-15 08:53:05 +02:00
*
2017-11-14 11:02:24 +01:00
* Returns a select tag containing all the appropriate option tags, with
* optgroup tags around the option tags as required.
2014-08-15 08:53:05 +02:00
*
* <b>Usage</b>
2014-08-15 08:53:05 +02:00
*
* <code>
* new GroupedDropdownField(
* $name = "dropdown",
* $title = "Simple Grouped Dropdown",
* $source = array(
* "numbers" => array(
2016-11-29 00:31:16 +01:00
* "1" => "1",
* "2" => "2",
* "3" => "3",
* "4" => "4"
* ),
* "letters" => array(
2016-11-29 00:31:16 +01:00
* "1" => "A",
* "2" => "B",
* "3" => "C",
* "4" => "D",
* "5" => "E",
* "6" => "F"
* )
* )
* )
* </code>
2014-08-15 08:53:05 +02:00
*
* <b>Disabling individual items</b>
2014-08-15 08:53:05 +02:00
*
* Unlike the source, disabled items are specified in the same way as
* normal DropdownFields, using a single value list. Don't pass in grouped
* values here.
*
* <code>
* // Disables first and third option in each group
* $groupedDrDownField->setDisabledItems(array("1", "3"))
* </code>
*/
2016-11-29 00:31:16 +01:00
class GroupedDropdownField extends DropdownField
{
2016-11-29 00:31:16 +01:00
// TODO remove this when GroupedDropdownField is implemented
// This should be one of SCHEMA_DATA_TYPE_* constants instead
/** @skipUpgrade */
2016-11-29 00:31:16 +01:00
protected $schemaDataType = 'GroupedDropdownField';
2016-11-29 00:31:16 +01:00
/**
* Build a potentially nested fieldgroup
*
* @param mixed $valueOrGroup Value of item, or title of group
* @param string|array $titleOrOptions Title of item, or options in grouip
* @return ArrayData Data for this item
*/
protected function getFieldOption($valueOrGroup, $titleOrOptions)
{
// Return flat option
if (!is_array($titleOrOptions)) {
return parent::getFieldOption($valueOrGroup, $titleOrOptions);
}
2016-11-29 00:31:16 +01:00
// Build children from options list
$options = new ArrayList();
foreach ($titleOrOptions as $childValue => $childTitle) {
$options->push($this->getFieldOption($childValue, $childTitle));
}
2016-11-29 00:31:16 +01:00
return new ArrayData(array(
'Title' => $valueOrGroup,
'Options' => $options
));
}
2016-11-29 00:31:16 +01:00
public function Type()
{
return 'groupeddropdown dropdown';
}
2016-11-29 00:31:16 +01:00
public function getSourceValues()
{
// Flatten values
$values = array();
$source = $this->getSource();
array_walk_recursive(
$source,
// Function to extract value from array key
function ($title, $value) use (&$values) {
$values[] = $value;
}
);
return $values;
}
}