Returns a renderable array for the fields on an entity.
Each field is displayed according to the display options specified in the $display parameter for the given view mode.
field_attach_prepare_view() and field_attach_view() are two halves of the same operation. It is safe to call field_attach_prepare_view() multiple times on the same entity before calling field_attach_view() on it, but calling any Field API operation on an entity between passing that entity to these two functions may yield incorrect results.
\Drupal\Core\Entity\EntityInterface $entity: The entity with fields to render.
\Drupal\entity\Plugin\Core\Entity\EntityDisplay $display: The entity display object.
$langcode: The language the field values are to be shown in. If no language is provided the current language is used.
array $options: An associative array of additional options. See field_invoke_method() for details. Note: key "langcode" will be overridden inside this function.
array A renderable array for the field values.
function field_attach_view(EntityInterface $entity, EntityDisplay $display, $langcode = NULL, array $options = array()) {
// Ensure we are working with a BC mode entity.
$entity = $entity
->getBCEntity();
// Determine the actual language code to display for each field, given the
// language codes available in the field data.
$options['langcode'] = field_language($entity, NULL, $langcode);
// For each instance, call the view() method on the formatter object handed
// by the entity display.
$target_function = function ($instance) use ($display) {
return $display
->getFormatter($instance['field_name']);
};
$null = NULL;
$output = field_invoke_method('view', $target_function, $entity, $null, $null, $options);
// Remove the BC layer now.
$entity = $entity
->getNGEntity();
// Let other modules alter the renderable array.
$view_mode = $display->originalMode;
$context = array(
'entity' => $entity,
'view_mode' => $view_mode,
'display_options' => $view_mode,
'langcode' => $langcode,
);
drupal_alter('field_attach_view', $output, $context);
// Reset the _field_view_prepared flag set in field_attach_prepare_view(),
// in case the same entity is displayed with different settings later in
// the request.
unset($entity->_field_view_prepared);
return $output;
}