public function FormatterInterface::prepareView

Allows formatters to load information for field values being displayed.

This should be used when a formatter needs to load additional information from the database in order to render a field, for example a reference field that displays properties of the referenced entities such as name or type.

This method operates on multiple entities. The $entities_items parameter is an array keyed by entity ID. For performance reasons, information for all involved entities should be loaded in a single query where possible.

Changes or additions to field values are done by directly altering the items.

Parameters

\Drupal\Core\Field\FieldItemListInterface[] $entities_items: An array with the field values from the multiple entities being rendered.

File

core/lib/Drupal/Core/Field/FormatterInterface.php, line 60

Class

FormatterInterface

Interface definition for field formatter plugins.

Namespace

Code

public function prepareView(array $entities_items);