Skip to content

Commit

Permalink
[Reference][Form Types] Add missing options for "form" type
Browse files Browse the repository at this point in the history
  • Loading branch information
bicpi committed Jan 23, 2014
1 parent f285d93 commit dd6c0a7
Show file tree
Hide file tree
Showing 4 changed files with 42 additions and 0 deletions.
5 changes: 5 additions & 0 deletions reference/forms/types/form.rst
Original file line number Diff line number Diff line change
Expand Up @@ -59,3 +59,8 @@ on all fields.

.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc

.. include:: /reference/forms/types/options/extra_fields_message.rst.inc

.. include:: /reference/forms/types/options/post_max_size_message.rst.inc

.. include:: /reference/forms/types/options/pattern.rst.inc
9 changes: 9 additions & 0 deletions reference/forms/types/options/extra_fields_message.rst.inc
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
extra_fields_message
~~~~~~~~~~~~~~~~~~~~

**type**: ``string`` **default**: ``This form should not contain extra fields.``

This is the validation error message that's used if the submitted form data
contains one or more fields that are not part of the form definition. The
placeholder ``{{ extra_fields }}`` can be used to display a comma separated
list of the submitted extra field names.
16 changes: 16 additions & 0 deletions reference/forms/types/options/pattern.rst.inc
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
pattern
~~~~~~~

**type**: ``string`` **default**: ``null``

This option adds a ``pattern`` attribute to restrict the field input by a
regular expression.

.. caution:

This validation is client-side only.

.. note:

When using validation constraints, this option is set automatically
for some constraints to match the server-side validation.
12 changes: 12 additions & 0 deletions reference/forms/types/options/post_max_size_message.rst.inc
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
post_max_size_message
~~~~~~~~~~~~~~~~~~~~~

**type**: ``string`` **default**: ``The uploaded file was too large. Please try to upload a smaller file.``

This is the validation error message that's used if submitted POST form data
exceeds php.ini's ``post_max_size``. The ``{{ max }}`` placeholder can be used
to display the allowed size.

.. note:

Validating the ``post_max_size`` only happens on the root form.

0 comments on commit dd6c0a7

Please sign in to comment.