Issue #2938743 by Manuel Garcia: Document #pattern property for email,...

Issue #2938743 by Manuel Garcia: Document #pattern property for email, password, tel, textfield, and url form elements

core/lib/Drupal/Core/Render/Element/Email.php

@@ -11,12 +11,14 @@
  * Properties:
  * - #default_value: An RFC-compliant email address.
  * - #size: The size of the input element in characters.
+ * - #pattern: A string for the native HTML5 pattern attribute.
  *
  * Example usage:
  * @code
  * $form['email'] = array(
  *   '#type' => 'email',
  *   '#title' => $this->t('Email'),
+ *   '#pattern' => '*@example.com',
  * );
  * @end
  *

core/lib/Drupal/Core/Render/Element/Password.php

@@ -10,6 +10,7 @@
  *
  * Properties:
  * - #size: The size of the input element in characters.
+ * - #pattern: A string for the native HTML5 pattern attribute.
  *
  * Usage example:
  * @code
@@ -17,6 +18,7 @@
  *   '#type' => 'password',
  *   '#title' => $this->t('Password'),
  *   '#size' => 25,
+ *   '#pattern' => '[01]+',
  * );
  * @endcode
  *

core/lib/Drupal/Core/Render/Element/Tel.php

@@ -12,12 +12,14 @@
  *
  * Properties:
  * - #size: The size of the input element in characters.
+ * - #pattern: A string for the native HTML5 pattern attribute.
  *
  * Usage example:
  * @code
  * $form['phone'] = array(
  *   '#type' => 'tel',
  *   '#title' => $this->t('Phone'),
+ *   '#pattern' => '[^\d]*',
  * );
  * @endcode
  *

core/lib/Drupal/Core/Render/Element/Textfield.php

@@ -15,6 +15,7 @@
  *   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
@@ -24,6 +25,7 @@
  *   '#default_value' => $node->title,
  *   '#size' => 60,
  *   '#maxlength' => 128,
+ *   '#pattern' => 'some-prefix-[a-z]+',
  *   '#required' => TRUE,
  * );
  * @endcode

core/lib/Drupal/Core/Render/Element/Url.php

@@ -12,6 +12,7 @@
  * Properties:
  * - #default_value: A valid URL string.
  * - #size: The size of the input element in characters.
+ * - #pattern: A string for the native HTML5 pattern attribute.
  *
  * Usage example:
  * @code
@@ -19,6 +20,7 @@
  *   '#type' => 'url',
  *   '#title' => $this->t('Home Page'),
  *   '#size' => 30,
+ *   '#pattern' => '*.example.com',
  *   ...
  * );
  * @endcode