NumericItemBase.php

Same filename in other branches
  1. 8.9.x core/lib/Drupal/Core/Field/Plugin/Field/FieldType/NumericItemBase.php
  2. 10 core/lib/Drupal/Core/Field/Plugin/Field/FieldType/NumericItemBase.php
  3. 11.x core/lib/Drupal/Core/Field/Plugin/Field/FieldType/NumericItemBase.php

Namespace

Drupal\Core\Field\Plugin\Field\FieldType

File

core/lib/Drupal/Core/Field/Plugin/Field/FieldType/NumericItemBase.php

View source
<?php

namespace Drupal\Core\Field\Plugin\Field\FieldType;

use Drupal\Core\Field\FieldItemBase;
use Drupal\Core\Form\FormStateInterface;

/**
 * Base class for numeric configurable field types.
 */
abstract class NumericItemBase extends FieldItemBase {
    
    /**
     * {@inheritdoc}
     */
    public static function defaultFieldSettings() {
        return [
            'min' => '',
            'max' => '',
            'prefix' => '',
            'suffix' => '',
        ] + parent::defaultFieldSettings();
    }
    
    /**
     * {@inheritdoc}
     */
    public function fieldSettingsForm(array $form, FormStateInterface $form_state) {
        $element = [];
        $settings = $this->getSettings();
        $element['min'] = [
            '#type' => 'number',
            '#title' => $this->t('Minimum'),
            '#default_value' => $settings['min'],
            '#description' => $this->t('The minimum value that should be allowed in this field. Leave blank for no minimum.'),
        ];
        $element['max'] = [
            '#type' => 'number',
            '#title' => $this->t('Maximum'),
            '#default_value' => $settings['max'],
            '#description' => $this->t('The maximum value that should be allowed in this field. Leave blank for no maximum.'),
        ];
        $element['prefix'] = [
            '#type' => 'textfield',
            '#title' => $this->t('Prefix'),
            '#default_value' => $settings['prefix'],
            '#size' => 60,
            '#description' => $this->t("Define a string that should be prefixed to the value, like '\$ ' or '&euro; '. Leave blank for none. Separate singular and plural values with a pipe ('pound|pounds')."),
        ];
        $element['suffix'] = [
            '#type' => 'textfield',
            '#title' => $this->t('Suffix'),
            '#default_value' => $settings['suffix'],
            '#size' => 60,
            '#description' => $this->t("Define a string that should be suffixed to the value, like ' m', ' kb/s'. Leave blank for none. Separate singular and plural values with a pipe ('pound|pounds')."),
        ];
        return $element;
    }
    
    /**
     * {@inheritdoc}
     */
    public function isEmpty() {
        if (empty($this->value) && (string) $this->value !== '0') {
            return TRUE;
        }
        return FALSE;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getConstraints() {
        $constraint_manager = \Drupal::typedDataManager()->getValidationConstraintManager();
        $constraints = parent::getConstraints();
        $settings = $this->getSettings();
        $label = $this->getFieldDefinition()
            ->getLabel();
        if (isset($settings['min']) && $settings['min'] !== '') {
            $min = $settings['min'];
            $constraints[] = $constraint_manager->create('ComplexData', [
                'value' => [
                    'Range' => [
                        'min' => $min,
                        'minMessage' => $this->t('%name: the value may be no less than %min.', [
                            '%name' => $label,
                            '%min' => $min,
                        ]),
                    ],
                ],
            ]);
        }
        if (isset($settings['max']) && $settings['max'] !== '') {
            $max = $settings['max'];
            $constraints[] = $constraint_manager->create('ComplexData', [
                'value' => [
                    'Range' => [
                        'max' => $max,
                        'maxMessage' => $this->t('%name: the value may be no greater than %max.', [
                            '%name' => $label,
                            '%max' => $max,
                        ]),
                    ],
                ],
            ]);
        }
        return $constraints;
    }
    
    /**
     * Helper method to truncate a decimal number to a given number of decimals.
     *
     * @param float $decimal
     *   Decimal number to truncate.
     * @param int $num
     *   Number of digits the output will have.
     *
     * @return float
     *   Decimal number truncated.
     */
    protected static function truncateDecimal($decimal, $num) {
        return floor($decimal * pow(10, $num)) / pow(10, $num);
    }

}

Classes

Title Deprecated Summary
NumericItemBase Base class for numeric configurable field types.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.