123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106 |
- <?php
- namespace Drupal\Core\Render\Element;
- use Drupal\Core\Form\FormStateInterface;
- use Drupal\Core\Render\Element;
- /**
- * Provides a one-line text field form element.
- *
- * Properties:
- * - #maxlength: Maximum number of characters of input allowed.
- * - #size: The size of the input element in characters.
- * - #autocomplete_route_name: A route to be used as callback URL by the
- * autocomplete JavaScript library.
- * - #autocomplete_route_parameters: An array of parameters to be used in
- * conjunction with the route name.
- * - #pattern: A string for the native HTML5 pattern attribute.
- *
- * Usage example:
- * @code
- * $form['title'] = array(
- * '#type' => 'textfield',
- * '#title' => $this->t('Subject'),
- * '#default_value' => $node->title,
- * '#size' => 60,
- * '#maxlength' => 128,
- * '#pattern' => 'some-prefix-[a-z]+',
- * '#required' => TRUE,
- * );
- * @endcode
- *
- * @see \Drupal\Core\Render\Element\Color
- * @see \Drupal\Core\Render\Element\Email
- * @see \Drupal\Core\Render\Element\MachineName
- * @see \Drupal\Core\Render\Element\Number
- * @see \Drupal\Core\Render\Element\Password
- * @see \Drupal\Core\Render\Element\PasswordConfirm
- * @see \Drupal\Core\Render\Element\Range
- * @see \Drupal\Core\Render\Element\Tel
- * @see \Drupal\Core\Render\Element\Url
- *
- * @FormElement("textfield")
- */
- class Textfield extends FormElement {
- /**
- * {@inheritdoc}
- */
- public function getInfo() {
- $class = get_class($this);
- return [
- '#input' => TRUE,
- '#size' => 60,
- '#maxlength' => 128,
- '#autocomplete_route_name' => FALSE,
- '#process' => [
- [$class, 'processAutocomplete'],
- [$class, 'processAjaxForm'],
- [$class, 'processPattern'],
- [$class, 'processGroup'],
- ],
- '#pre_render' => [
- [$class, 'preRenderTextfield'],
- [$class, 'preRenderGroup'],
- ],
- '#theme' => 'input__textfield',
- '#theme_wrappers' => ['form_element'],
- ];
- }
- /**
- * {@inheritdoc}
- */
- public static function valueCallback(&$element, $input, FormStateInterface $form_state) {
- if ($input !== FALSE && $input !== NULL) {
- // This should be a string, but allow other scalars since they might be
- // valid input in programmatic form submissions.
- if (!is_scalar($input)) {
- $input = '';
- }
- return str_replace(["\r", "\n"], '', $input);
- }
- return NULL;
- }
- /**
- * Prepares a #type 'textfield' render element for input.html.twig.
- *
- * @param array $element
- * An associative array containing the properties of the element.
- * Properties used: #title, #value, #description, #size, #maxlength,
- * #placeholder, #required, #attributes.
- *
- * @return array
- * The $element with prepared variables ready for input.html.twig.
- */
- public static function preRenderTextfield($element) {
- $element['#attributes']['type'] = 'text';
- Element::setAttributes($element, ['id', 'name', 'value', 'size', 'maxlength', 'placeholder']);
- static::setAttributes($element, ['form-text']);
- return $element;
- }
- }
|