Interface for fields, being lists of field items.
This interface must be implemented by every entity field, whereas contained field items must implement the FieldItemInterface. Some methods of the fields are delegated to the first contained item, in particular get() and set() as well as their magic equivalences.
Optionally, a typed data object implementing Drupal\Core\TypedData\TypedDataInterface may be passed to ArrayAccess::offsetSet() instead of a plain value.
When implementing this interface which extends Traversable, make sure to list IteratorAggregate or Iterator before this interface in the implements clause.
Expanded class hierarchy of FieldInterface
All classes that implement FieldInterface
interface FieldInterface extends ListInterface, AccessibleInterface {
/**
* Filters out empty field items and re-numbers the item deltas.
*/
public function filterEmptyValues();
/**
* Gets a property object from the first field item.
*
* @see \Drupal\Core\Entity\Field\FieldItemInterface::get()
*/
public function get($property_name);
/**
* Magic method: Gets a property value of to the first field item.
*
* @see \Drupal\Core\Entity\Field\FieldItemInterface::__get()
*/
public function __get($property_name);
/**
* Magic method: Sets a property value of the first field item.
*
* @see \Drupal\Core\Entity\Field\FieldItemInterface::__set()
*/
public function __set($property_name, $value);
/**
* Magic method: Determines whether a property of the first field item is set.
*
* @see \Drupal\Core\Entity\Field\FieldItemInterface::__isset()
*/
public function __isset($property_name);
/**
* Magic method: Unsets a property of the first field item.
*
* @see \Drupal\Core\Entity\Field\FieldItemInterface::__unset()
*/
public function __unset($property_name);
/**
* Gets the definition of a property of the first field item.
*
* @see \Drupal\Core\Entity\Field\FieldItemInterface::getPropertyDefinition()
*/
public function getPropertyDefinition($name);
/**
* Gets an array of property definitions of the first field item.
*
* @see \Drupal\Core\Entity\Field\FieldItemInterface::getPropertyDefinitions()
*/
public function getPropertyDefinitions();
}
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
TypedDataInterface:: |
public | function | Validates the currently set data value. | 4 |
TypedDataInterface:: |
public | function | Sets the data value. | 4 |
TypedDataInterface:: |
public | function | Sets the context of a property or item via a context aware parent. | 4 |
TypedDataInterface:: |
public | function | Gets the data value. | 4 |
TypedDataInterface:: |
public | function | Gets the data type. | 5 |
TypedDataInterface:: |
public | function | Returns a string representation of the data. | 4 |
TypedDataInterface:: |
public | function | Returns the root of the typed data tree. | 4 |
TypedDataInterface:: |
public | function | Returns the property path of the data. | 4 |
TypedDataInterface:: |
public | function | Returns the parent data structure; i.e. either complex data or a list. | 4 |
TypedDataInterface:: |
public | function | Returns the name of a property or item. | 4 |
TypedDataInterface:: |
public | function | Gets the data definition. | 4 |
TypedDataInterface:: |
public | function | Gets a list of validation constraints. | 4 |
ListInterface:: |
public | function | React to changes to a child item. | 2 |
ListInterface:: |
public | function | Determines whether the list contains any non-empty items. | 2 |
ListInterface:: |
public | function | Gets the definition of a contained item. | 2 |
FieldInterface:: |
public | function | Magic method: Unsets a property of the first field item. | 1 |
FieldInterface:: |
public | function | Magic method: Sets a property value of the first field item. | 1 |
FieldInterface:: |
public | function | Magic method: Determines whether a property of the first field item is set. | 1 |
FieldInterface:: |
public | function | Magic method: Gets a property value of to the first field item. | 1 |
FieldInterface:: |
public | function | Gets an array of property definitions of the first field item. | 1 |
FieldInterface:: |
public | function | Gets the definition of a property of the first field item. | 1 |
FieldInterface:: |
public | function | Gets a property object from the first field item. | 1 |
FieldInterface:: |
public | function | Filters out empty field items and re-numbers the item deltas. | 1 |
AccessibleInterface:: |
public | function | Checks data value access. | 5 |