diff --git a/reference/forms/types/options/compound.rst.inc b/reference/forms/types/options/compound.rst.inc index 7736a77567c..10fe4d35a9e 100644 --- a/reference/forms/types/options/compound.rst.inc +++ b/reference/forms/types/options/compound.rst.inc @@ -3,6 +3,22 @@ compound **type**: ``boolean`` **default**: ``true`` -This option specifies if a form is compound. This is independent of whether -the form actually has children. A form can be compound but not have any -children at all (e.g. an empty collection form). +If ``true`` this option creates the form as "compound", meaning that it +can contain children and be a parent of other forms. + +Most of the time you won't need to override this option. +You might want to control for it when creating a custom form type +with advanced rendering logic. + +In a view a compound form is rendered as a ``
`` container or +a ``
`` element (the whole form is obviously a compound form). + +Non-compound forms are always leaves in a form tree, they cannot have children. + +A non-compound form is rendered as one of the html form elements: ```` +(``TextType``, ``FileType``, ``HiddenType``), ``