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 | Gets the data type. | 5 |
AccessibleInterface:: |
public | function | Checks data value access. | 5 |
TypedDataInterface:: |
public | function | Gets the data definition. | 4 |
TypedDataInterface:: |
public | function | Gets the data value. | 4 |
TypedDataInterface:: |
public | function | Sets the data value. | 4 |
TypedDataInterface:: |
public | function | Returns a string representation of the data. | 4 |
TypedDataInterface:: |
public | function | Gets a list of validation constraints. | 4 |
TypedDataInterface:: |
public | function | Validates the currently set data value. | 4 |
TypedDataInterface:: |
public | function | Returns the name of a property or item. | 4 |
TypedDataInterface:: |
public | function | Returns the parent data structure; i.e. either complex data or a list. | 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 | Sets the context of a property or item via a context aware parent. | 4 |
ListInterface:: |
public | function | Determines whether the list contains any non-empty items. | 2 |
ListInterface:: |
public | function | Gets the definition of a contained item. | 2 |
ListInterface:: |
public | function | React to changes to a child item. | 2 |
FieldInterface:: |
public | function | Filters out empty field items and re-numbers the item deltas. | 1 |
FieldInterface:: |
public | function | Gets a property object from the first field item. | 1 |
FieldInterface:: |
public | function | Magic method: Gets a property value of to 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: Unsets a property 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 an array of property definitions of the first field item. | 1 |