public static MachineName::validateMachineName(&$element, FormStateInterface $form_state, &$complete_form)
Form element validation handler for machine_name elements.
Note that #maxlength is validated by _form_validate() already.
This checks that the submitted value:
- Does not contain the replacement character only.
- Does not contain disallowed characters.
- Is unique; i.e., does not already exist.
- Does not exceed the maximum length (via #maxlength).
- Cannot be changed after creation (via #disabled).
File
- core/lib/Drupal/Core/Render/Element/MachineName.php, line 219
Class
- MachineName
- Provides a machine name render element.
Namespace
Drupal\Core\Render\Element
Code
public static function validateMachineName(&$element, FormStateInterface $form_state, &$complete_form) { // Verify that the machine name not only consists of replacement tokens. if (preg_match('@^' . $element['#machine_name']['replace'] . '+$@', $element['#value'])) { $form_state->setError($element, t('The machine-readable name must contain unique characters.')); } // Verify that the machine name contains no disallowed characters. if (preg_match('@' . $element['#machine_name']['replace_pattern'] . '@', $element['#value'])) { if (!isset($element['#machine_name']['error'])) { // Since a hyphen is the most common alternative replacement character, // a corresponding validation error message is supported here. if ($element['#machine_name']['replace'] == '-') { $form_state->setError($element, t('The machine-readable name must contain only lowercase letters, numbers, and hyphens.')); } // Otherwise, we assume the default (underscore). else { $form_state->setError($element, t('The machine-readable name must contain only lowercase letters, numbers, and underscores.')); } } else { $form_state->setError($element, $element['#machine_name']['error']); } } // Verify that the machine name is unique. if ($element['#default_value'] !== $element['#value']) { $function = $element['#machine_name']['exists']; if (call_user_func($function, $element['#value'], $element, $form_state)) { $form_state->setError($element, t('The machine-readable name is already in use. It must be unique.')); } } }
Please login to continue.