minor #13656 [Form] Added an html5 option to ColorType (javiereguiluz)

javiereguiluz · javiereguiluz · commit 3b2031bd2ca0 · 2020-05-12T11:25:53.000+02:00
This PR was squashed before being merged into the master branch. Discussion ---------- [Form] Added an html5 option to ColorType Fixes #13637. Commits ------- fcee158 [Form] Added an html5 option to ColorType
diff --git a/reference/forms/types/color.rst b/reference/forms/types/color.rst
@@ -17,6 +17,8 @@ element.
 +-------------+---------------------------------------------------------------------+
 | Rendered as | ``input`` ``color`` field (a text box)                              |
 +-------------+---------------------------------------------------------------------+
+| Options     | - `html5`_                                                          |
++-------------+---------------------------------------------------------------------+
 | Inherited   | - `attr`_                                                           |
 | options     | - `data`_                                                           |
 |             | - `disabled`_                                                       |
@@ -41,6 +43,22 @@ element.
 
 .. include:: /reference/forms/types/options/_debug_form.rst.inc
 
+Field Options
+-------------
+
+html5
+~~~~~
+
+**type**: ``bool`` **default**: ``false``
+
+.. versionadded:: 5.1
+
+    This option was introduced in Symfony 5.1.
+
+When this option is set to ``true``, the form type checks that its value matches
+the `HTML5 color format`_ (``/^#[0-9a-f]{6}$/i``). If it doesn't match it,
+you'll see the following error message: *"This value is not a valid HTML5 color"*.
+
 Inherited Options
 -----------------
 
@@ -83,3 +101,5 @@ The default value is ``''`` (the empty string).
 .. include:: /reference/forms/types/options/row_attr.rst.inc
 
 .. include:: /reference/forms/types/options/trim.rst.inc
+
+.. _`HTML5 color format`: https://www.w3.org/TR/html52/sec-forms.html#color-state-typecolor
