You are here

protected function BatOptionsCombined::formMultipleElements in Booking and Availability Management Tools for Drupal 8

Special handling to create form elements for multiple values.

Handles generic features for multiple fields:

  • number of widgets
  • AHAH-'add more' button
  • table display and drag-n-drop value reordering

Overrides WidgetBase::formMultipleElements

File

modules/bat_options/src/Plugin/Field/FieldWidget/BatOptionsCombined.php, line 75
Contains \Drupal\bat_options\Plugin\Field\FieldWidget\BatOptionsCombined.

Class

BatOptionsCombined
Plugin annotation @FieldWidget( id = "bat_options_combined", label = @Translation("Combined text field'"), field_types = { "bat_options" } )

Namespace

Drupal\bat_options\Plugin\Field\FieldWidget

Code

protected function formMultipleElements(FieldItemListInterface $items, array &$form, FormStateInterface $form_state) {
  $field_name = $this->fieldDefinition
    ->getName();
  $cardinality = $this->fieldDefinition
    ->getFieldStorageDefinition()
    ->getCardinality();
  $parents = $form['#parents'];
  $id_prefix = implode('-', array_merge($parents, [
    $field_name,
  ]));
  $wrapper_id = Html::getUniqueId($id_prefix . '-add-more-wrapper');
  $field_state = [];

  // Determine the number of widgets to display.
  switch ($cardinality) {
    case FieldStorageDefinitionInterface::CARDINALITY_UNLIMITED:
      $field_state = static::getWidgetState($parents, $field_name, $form_state);
      $max = $field_state['items_count'];
      $is_multiple = TRUE;
      break;
    default:
      $max = $cardinality - 1;
      $is_multiple = $cardinality > 1;
      break;
  }
  $title = $this->fieldDefinition
    ->getLabel();
  $description = FieldFilteredMarkup::create($this->token
    ->replace($this->fieldDefinition
    ->getDescription()));
  $elements = [];
  for ($delta = 0; $delta <= $max; $delta++) {

    // Add a new empty item if it doesn't exist yet at this delta.
    if (!isset($items[$delta])) {
      $items
        ->appendItem();
    }

    // For multiple fields, title and description are handled by the wrapping
    // table.
    if ($is_multiple) {
      $element = [
        '#title' => $this
          ->t('@title (value @number)', [
          '@title' => $title,
          '@number' => $delta + 1,
        ]),
        '#title_display' => 'invisible',
        '#description' => '',
      ];
    }
    else {
      $element = [
        '#title' => $title,
        '#title_display' => 'before',
        '#description' => $description,
      ];
    }
    $element = $this
      ->formSingleElement($items, $delta, $element, $form, $form_state);
    if ($element) {

      // Input field for the delta (drag-n-drop reordering).
      if ($is_multiple) {

        // We name the element '_weight' to avoid clashing with elements
        // defined by widget.
        $element['_weight'] = [
          '#type' => 'weight',
          '#title' => $this
            ->t('Weight for row @number', [
            '@number' => $delta + 1,
          ]),
          '#title_display' => 'invisible',
          // Note: this 'delta' is the FAPI #type 'weight' element's property.
          '#delta' => $max,
          '#default_value' => $items[$delta]->_weight ?: $delta,
          '#weight' => 100,
        ];
      }
      if ($cardinality == FieldStorageDefinitionInterface::CARDINALITY_UNLIMITED && !$form_state
        ->isProgrammed() && $field_state['items_count'] > 0) {
        $element['remove_item'] = [
          '#type' => 'submit',
          '#value' => $this
            ->t('Remove item'),
          '#submit' => [
            [
              get_class($this),
              'removeItemSubmit',
            ],
          ],
          '#ajax' => [
            'callback' => [
              get_class($this),
              'removeItemAjax',
            ],
            'wrapper' => $wrapper_id,
            'effect' => 'fade',
          ],
          '#name' => implode('_', array_merge($parents, [
            $field_name,
            $delta,
            'remove_item',
          ])),
          '#attributes' => [
            'class' => [
              'field-remove-item-submit',
            ],
          ],
          '#limit_validation_errors' => [
            array_merge($parents, [
              $field_name,
            ]),
          ],
          '#weight' => 100,
        ];
      }
      $elements[$delta] = $element;
    }
  }
  if ($elements) {
    $elements += [
      '#theme' => 'field_multiple_value_form',
      '#field_name' => $field_name,
      '#cardinality' => $cardinality,
      '#cardinality_multiple' => $this->fieldDefinition
        ->getFieldStorageDefinition()
        ->isMultiple(),
      '#required' => $this->fieldDefinition
        ->isRequired(),
      '#title' => $title,
      '#description' => $description,
      '#max_delta' => $max,
    ];

    // Add 'add more' button, if not working with a programmed form.
    if ($cardinality == FieldStorageDefinitionInterface::CARDINALITY_UNLIMITED && !$form_state
      ->isProgrammed()) {
      $elements['#prefix'] = '<div id="' . $wrapper_id . '">';
      $elements['#suffix'] = '</div>';
      $elements['add_more'] = [
        '#type' => 'submit',
        '#name' => strtr($id_prefix, '-', '_') . '_add_more',
        '#value' => t('Add another item'),
        '#attributes' => [
          'class' => [
            'field-add-more-submit',
          ],
        ],
        '#limit_validation_errors' => [
          array_merge($parents, [
            $field_name,
          ]),
        ],
        '#submit' => [
          [
            get_class($this),
            'addMoreSubmit',
          ],
        ],
        '#ajax' => [
          'callback' => [
            get_class($this),
            'addMoreAjax',
          ],
          'wrapper' => $wrapper_id,
          'effect' => 'fade',
        ],
      ];
    }
  }
  return $elements;
}