function Number::validateNumber

Same name in other branches
  1. 9 core/lib/Drupal/Core/Render/Element/Number.php \Drupal\Core\Render\Element\Number::validateNumber()
  2. 8.9.x core/lib/Drupal/Core/Render/Element/Number.php \Drupal\Core\Render\Element\Number::validateNumber()
  3. 10 core/lib/Drupal/Core/Render/Element/Number.php \Drupal\Core\Render\Element\Number::validateNumber()

Form element validation handler for #type 'number'.

Note that #required is validated by _form_validate() already.

File

core/lib/Drupal/Core/Render/Element/Number.php, line 62

Class

Number
Provides a form element for numeric input, with special numeric validation.

Namespace

Drupal\Core\Render\Element

Code

public static function validateNumber(&$element, FormStateInterface $form_state, &$complete_form) {
    $value = $element['#value'];
    if ($value === '') {
        return;
    }
    $name = empty($element['#title']) ? $element['#parents'][0] : $element['#title'];
    // Ensure the input is numeric.
    if (!is_numeric($value)) {
        $form_state->setError($element, t('%name must be a number.', [
            '%name' => $name,
        ]));
        return;
    }
    // Ensure that the input is greater than the #min property, if set.
    if (isset($element['#min']) && $value < $element['#min']) {
        $form_state->setError($element, t('%name must be higher than or equal to %min.', [
            '%name' => $name,
            '%min' => $element['#min'],
        ]));
    }
    // Ensure that the input is less than the #max property, if set.
    if (isset($element['#max']) && $value > $element['#max']) {
        $form_state->setError($element, t('%name must be lower than or equal to %max.', [
            '%name' => $name,
            '%max' => $element['#max'],
        ]));
    }
    if (isset($element['#step']) && strtolower($element['#step']) != 'any') {
        // Check that the input is an allowed multiple of #step (offset by #min if
        // #min is set).
        $offset = $element['#min'] ?? 0.0;
        if (!NumberUtility::validStep($value, $element['#step'], $offset)) {
            $form_state->setError($element, t('%name is not a valid number.', [
                '%name' => $name,
            ]));
        }
    }
}

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