public function ListFieldDiffParser::build in Entity Share 8.3

Builds an array of strings.

This method is responsible for transforming a FieldItemListInterface object into an array of strings. The resulted array of strings is then compared by the Diff component with another such array of strings and the result represents the difference between two entity fields.

Example of FieldItemListInterface built into an array of strings:

array(
  0 => "This is an example string",
  1 => "Field values or properties",
);

Parameters

\Drupal\Core\Field\FieldItemListInterface $field_items: Represents an entity field.

Return value

mixed An array of strings to be compared. If an empty array is returned it means that a field is either empty or no properties need to be compared for that field.

Overrides DiffGeneratorInterface::build

See also

\Drupal\entity_share_diff\Plugin\DiffGenerator\CoreFieldDiffParser

File

modules/entity_share_diff/src/Plugin/DiffGenerator/ListFieldDiffParser.php, line 28

Class

ListFieldDiffParser

Plugin to diff list fields.

Namespace

Drupal\entity_share_diff\Plugin\DiffGenerator

Code

public function build(FieldItemListInterface $field_items, array $remote_field_data = []) {
  $result = [];

  // Every item from $field_items is of type FieldItemInterface.
  foreach ($field_items as $field_key => $field_item) {

    // Build the array for comparison only if the field is not empty.
    if (!$field_item
      ->isEmpty()) {
      $possible_options = $field_item
        ->getPossibleOptions();
      $values = $field_item
        ->getValue();
      if ($possible_options) {
        $result[$field_key] = $possible_options[$values['value']] . ' (' . $values['value'] . ')';
      }
      else {
        $result[$field_key] = $possible_options[$values['value']];
      }
    }
  }
  return $result;
}