Builds a renderable array for a field value.

Parameters

\Drupal\Core\Field\FieldItemListInterface $items: The field values to be rendered.

string $langcode: The language that should be used to render the field.

Return value

array A renderable array for $items, as an array of child elements keyed by consecutive numeric indexes starting from 0.

Overrides FormatterInterface::viewElements

File

core/modules/field/tests/modules/field_test/src/Plugin/Field/FieldFormatter/TestFieldEmptyFormatter.php, line 34

Class

TestFieldEmptyFormatter

Plugin implementation of the 'field_empty_test' formatter.

Namespace

Drupal\field_test\Plugin\Field\FieldFormatter

Code

public function viewElements(FieldItemListInterface $items, $langcode) {
  $elements = [];
  if ($items->isEmpty()) {
    // For fields with no value, just add the configured "empty" value.
    $elements[0] = [
      '#markup' => $this->getSetting('test_empty_string'),
    ];
  }
  else {
    foreach ($items as $delta => $item) {
      // This formatter only needs to output raw for testing.
      $elements[$delta] = [
        '#markup' => $item->value,
      ];
    }
  }
  return $elements;
}

---