Newer
Older
Angie Byron
committed
<?php
namespace Drupal\Core\TypedData;
/**
* A typed data definition class for defining lists.
Angie Byron
committed
*/
class ListDataDefinition extends DataDefinition implements ListDataDefinitionInterface {
Angie Byron
committed
/**
* The data definition of a list item.
*
* @var \Drupal\Core\TypedData\DataDefinitionInterface
*/
protected $itemDefinition;
/**
* Creates a new list definition.
*
* @param string $item_type
* The data type of the list items; e.g., 'string', 'integer' or 'any'.
*
* @return \Drupal\Core\TypedData\ListDataDefinition
Angie Byron
committed
* A new List Data Definition object.
*/
public static function create($item_type) {
return static::createFromItemType($item_type);
}
/**
* {@inheritdoc}
*/
public static function createFromDataType($type) {
$definition = parent::createFromDataType($type);
// If nothing else given, default to a list of 'any' items.
$definition->itemDefinition = DataDefinition::create('any');
return $definition;
}
/**
* {@inheritdoc}
*/
public static function createFromItemType($item_type) {
return new static(array(), \Drupal::typedDataManager()->createDataDefinition($item_type));
Angie Byron
committed
}
/**
* {@inheritdoc}
*/
public function __construct(array $values = array(), DataDefinitionInterface $item_definition = NULL) {
$this->definition = $values;
$this->itemDefinition = $item_definition;
Angie Byron
committed
}
/**
* {@inheritdoc}
*/
public function getDataType() {
return 'list';
}
/**
* {@inheritdoc}
*/
public function setDataType($type) {
if ($type != 'list') {
throw new \LogicException('Lists must always be of data type "list".');
}
}
/**
* {@inheritdoc}
*/
public function getClass() {
$class = isset($this->definition['class']) ? $this->definition['class'] : NULL;
if (!empty($class)) {
return $class;
}
else {
// If a list definition is used but no class has been specified, derive
// the default list class from the item type.
$item_type_definition = \Drupal::typedDataManager()
Angie Byron
committed
->getDefinition($this->getItemDefinition()->getDataType());
Alex Pott
committed
if (!$item_type_definition) {
catch
committed
throw new \LogicException("An invalid data type '{$this->getItemDefinition()->getDataType()}' has been specified for list items");
Alex Pott
committed
}
Angie Byron
committed
return $item_type_definition['list_class'];
}
}
/**
* {@inheritdoc}
*/
public function getItemDefinition() {
return $this->itemDefinition;
}
/**
* Sets the item definition.
*
* @param \Drupal\Core\TypedData\DataDefinition $definition
* A list item's data definition.
*
Angie Byron
committed
* @return $this
Angie Byron
committed
*/
public function setItemDefinition(DataDefinitionInterface $definition) {
$this->itemDefinition = $definition;
return $this;
}
}