Provide a formatter which limits and provides offsets

config/schema/field_formatter.schema.yml

@@ -30,3 +30,19 @@ field.formatter.settings.field_link:
     settings:
       label: 'Formatter settings'
       type: field.formatter.settings.[%parent.type]
+
+field.formatter.settings.field_formatter_limiter:
+  type: mapping
+  mapping:
+    type:
+      label: 'Machine name of the formatter'
+      type: string
+    settings:
+      label: 'Formatter settings'
+      type: field.formatter.settings.[%parent.type]
+    offset:
+      type: integer
+      label: 'Offset'
+    limit:
+      type: integer
+      label: 'Limit'

field_formatter.module

@@ -14,4 +14,5 @@ function field_formatter_field_formatter_info_alter(array &$info) {
   $field_types = array_keys($field_type_manager->getDefinitions());
 
   $info['field_link']['field_types'] = $field_types;
+  $info['field_formatter_limite']['field_types'] = $field_types;
 }

src/Plugin/Field/FieldFormatter/FieldFormatterBase.php

@@ -15,7 +15,7 @@ abstract class FieldFormatterBase extends EntityReferenceFormatterBase {
   /**
    * Entity view display.
    *
-   * @var \Drupal\Core\Entity\Display\EntityViewDisplayInterface
+   * @var \Drupal\Core\Entity\Display\EntityViewDisplayInterface[]
    */
   protected $viewDisplay;
 

src/Plugin/Field/FieldFormatter/FieldFormatterLimiter.php

@@ -0,0 +1,84 @@
+<?php
+
+namespace Drupal\field_formatter\Plugin\Field\FieldFormatter;
+
+use Drupal\Core\Field\FieldDefinitionInterface;
+use Drupal\Core\Field\FieldItemListInterface;
+use Drupal\Core\Form\FormStateInterface;
+
+/**
+ * Plugin implementation of the 'field_formatter_limiter' formatter.
+ *
+ * @FieldFormatter(
+ *   id = "field_formatter_limiter",
+ *   label = @Translation("Limit the amount of deltas being output"),
+ *   field_types = {
+ *     "entity_reference"
+ *   }
+ * )
+ */
+class FieldFormatterLimiter extends FieldWrapperBase {
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function defaultSettings() {
+    $settings = parent::defaultSettings();
+    $settings['limit'] = 0;
+    $settings['offset'] = 0;
+    return $settings;
+  }
+
+  /**
+   * Returns the cardinality setting of the field instance.
+   */
+  protected function getCardinality() {
+    if ($this->fieldDefinition instanceof FieldDefinitionInterface) {
+      return $this->fieldDefinition->getFieldStorageDefinition()->getCardinality();
+    }
+    return 0;
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function settingsForm(array $form, FormStateInterface $form_state) {
+    if ($this->getCardinality() == 1) {
+      return [];
+    }
+
+    $element['offset'] = [
+      '#type' => 'number',
+      '#title' => $this->t('Skip items'),
+      '#default_value' => $this->getSetting('offset'),
+      '#required' => TRUE,
+      '#min' => 0,
+      '#description' => $this->t('Number of items to skip from the beginning.')
+    ];
+
+    $element['limit'] = [
+      '#type' => 'number',
+      '#title' => $this->t('Display items'),
+      '#default_value' => $this->getSetting('limit'),
+      '#required' => TRUE,
+      '#min' => 0,
+      '#description' => $this->t('Number of items to display. Set to 0 to display all items.')
+    ];
+
+    return $element;
+   }
+
+  /**
+   * {@inheritdoc}
+   */
+  public function viewElements(FieldItemListInterface $items, $langcode) {
+    $field_output = $this->getFieldOutput($items, $langcode);
+
+    $offset = $this->getSetting('offset');
+    // Array_slice needs NULL to show all elements.
+    $limit = $this->getSetting('limit') == 0 ? NULL : $this->getSetting('limit');
+
+    return array_slice($field_output, $offset, $limit);
+  }
+
+}

src/Plugin/Field/FieldFormatter/FieldWrapperBase.php

@@ -22,7 +22,7 @@ abstract class FieldWrapperBase extends FormatterBase implements ContainerFactor
   /**
    * Entity view display.
    *
-   * @var \Drupal\Core\Entity\Display\EntityViewDisplayInterface
+   * @var \Drupal\Core\Entity\Display\EntityViewDisplayInterface[]
    */
   protected $viewDisplay;