ListFloatItem.php 3.62 KB
Newer Older
1 2 3 4
<?php

namespace Drupal\options\Plugin\Field\FieldType;

5
use Drupal\Core\Field\FieldFilteredMarkup;
6
use Drupal\Core\Field\FieldStorageDefinitionInterface;
7 8 9 10 11 12 13 14 15
use Drupal\Core\TypedData\DataDefinition;

/**
 * Plugin implementation of the 'list_float' field type.
 *
 * @FieldType(
 *   id = "list_float",
 *   label = @Translation("List (float)"),
 *   description = @Translation("This field stores float values from a list of allowed 'value => label' pairs, i.e. 'Fraction': 0 => 0, .25 => 1/4, .75 => 3/4, 1 => 1."),
16
 *   category = @Translation("Number"),
17 18 19 20 21 22
 *   default_widget = "options_select",
 *   default_formatter = "list_default",
 * )
 */
class ListFloatItem extends ListItemBase {

23 24 25
  /**
   * {@inheritdoc}
   */
26
  public static function propertyDefinitions(FieldStorageDefinitionInterface $field_definition) {
27
    $properties['value'] = DataDefinition::create('float')
28 29
      ->setLabel(t('Float value'))
      ->setRequired(TRUE);
30 31 32 33

    return $properties;
  }

34 35 36
  /**
   * {@inheritdoc}
   */
37
  public static function schema(FieldStorageDefinitionInterface $field_definition) {
38 39 40
    return [
      'columns' => [
        'value' => [
41
          'type' => 'float',
42 43 44 45 46 47
        ],
      ],
      'indexes' => [
        'value' => ['value'],
      ],
    ];
48 49 50 51 52
  }

  /**
   * {@inheritdoc}
   */
53 54 55 56 57 58
  protected function allowedValuesDescription() {
    $description = '<p>' . t('The possible values this field can contain. Enter one value per line, in the format key|label.');
    $description .= '<br/>' . t('The key is the stored value, and must be numeric. The label will be used in displayed values and edit forms.');
    $description .= '<br/>' . t('The label is optional: if a line contains a single number, it will be used as key and label.');
    $description .= '<br/>' . t('Lists of labels are also accepted (one label per line), only if the field does not hold any values yet. Numeric keys will be automatically generated from the positions in the list.');
    $description .= '</p>';
59
    $description .= '<p>' . t('Allowed HTML tags in labels: @tags', ['@tags' => FieldFilteredMarkup::displayAllowedTags()]) . '</p>';
60 61
    return $description;
  }
62

63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87
  /**
   * {@inheritdoc}
   */
  protected static function extractAllowedValues($string, $has_data) {
    $values = parent::extractAllowedValues($string, $has_data);
    if ($values) {
      $keys = array_keys($values);
      $labels = array_values($values);
      $keys = array_map(function ($key) {
        // Float keys are represented as strings and need to be disambiguated
        // ('.5' is '0.5').
        return is_numeric($key) ? (string) (float) $key : $key;
      }, $keys);

      return array_combine($keys, $labels);
    }
  }

  /**
   * {@inheritdoc}
   */
  protected static function validateAllowedValue($option) {
    if (!is_numeric($option)) {
      return t('Allowed values list: each key must be a valid integer or decimal.');
    }
88 89
  }

90 91 92 93
  /**
   * {@inheritdoc}
   */
  public static function simplifyAllowedValues(array $structured_values) {
94
    $values = [];
95 96 97 98 99 100 101 102
    foreach ($structured_values as $item) {
      // Nested elements are embedded in the label.
      if (is_array($item['label'])) {
        $item['label'] = static::simplifyAllowedValues($item['label']);
      }
      // Cast the value to a float first so that .5 and 0.5 are the same value
      // and then cast to a string so that values like 0.5 can be used as array
      // keys.
103
      // @see http://php.net/manual/language.types.array.php
104 105 106 107 108
      $values[(string) (float) $item['value']] = $item['label'];
    }
    return $values;
  }

109 110 111 112 113 114 115
  /**
   * {@inheritdoc}
   */
  protected static function castAllowedValue($value) {
    return (float) $value;
  }

116
}