diff --git a/reference/forms/types/form.rst b/reference/forms/types/form.rst index 4464f763e05..e327adb318d 100644 --- a/reference/forms/types/form.rst +++ b/reference/forms/types/form.rst @@ -9,14 +9,18 @@ See :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`. The ``form`` type predefines a couple of options that are then available on all fields. -.. include:: /reference/forms/types/options/compound.rst.inc - .. include:: /reference/forms/types/options/data.rst.inc .. include:: /reference/forms/types/options/data_class.rst.inc +.. include:: /reference/forms/types/options/action.rst.inc + +.. include:: /reference/forms/types/options/method.rst.inc + .. include:: /reference/forms/types/options/empty_data.rst.inc +.. include:: /reference/forms/types/options/compound.rst.inc + .. _reference-form-option-required: .. include:: /reference/forms/types/options/required.rst.inc @@ -68,7 +72,3 @@ on all fields. .. _reference-form-option-pattern: .. include:: /reference/forms/types/options/pattern.rst.inc - -.. include:: /reference/forms/types/options/action.rst.inc - -.. include:: /reference/forms/types/options/method.rst.inc diff --git a/reference/forms/types/options/action.rst.inc b/reference/forms/types/options/action.rst.inc index 70977722000..90dd1835613 100644 --- a/reference/forms/types/options/action.rst.inc +++ b/reference/forms/types/options/action.rst.inc @@ -6,7 +6,7 @@ action **type**: ``string`` **default**: empty string -This option specifies where to send the form's data on submission (usually an +This option specifies where to send the form's data on submission (usually a URI). Its value is rendered as the ``action`` attribute of the ``form`` element. An empty value is considered a same-document reference, i.e. the form will be submitted to the same URI that rendered the form. diff --git a/reference/forms/types/options/method.rst.inc b/reference/forms/types/options/method.rst.inc index d1d6c84b1ce..592191776a6 100644 --- a/reference/forms/types/options/method.rst.inc +++ b/reference/forms/types/options/method.rst.inc @@ -26,6 +26,8 @@ used to decide whether to process the form submission in the .. note: - Only the PATCH method allows submitting partial data without that missing - fields are set to ``null`` in the underlying data (preserving default - values, if any). + The PATCH method allows submitting partial data. In other words, if the + submitted form data is missing certain fields, those will be ignored + and the default values (if any) will be used. With all other HTTP methods, + if the submitted form data is missing some fields, those fields are set + to ``null``.