feature #6450 [Form] added prototype_data option in CollectionType (kgilden, HeahDude)

wouterj · wouterj · commit b11023f44ac0 · 2016-04-18T22:40:53.000+02:00
This PR was merged into the 2.8 branch. Discussion ---------- [Form] added prototype_data option in CollectionType | Q | A | |----|----| | Branch | 2.8+ | | New doc | finishes #4367 | Commits ------- 95bda57 [Form] defined default and added example CollectionType `prototype_data` option e18dc1f [Form] Document CollectionType's `prototype_data`
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
@@ -20,6 +20,7 @@ photos).
 |             | - `entry_options`_                                                          |
 |             | - `entry_type`_                                                             |
 |             | - `prototype`_                                                              |
+|             | - `prototype_data`_                                                         |
 |             | - `prototype_name`_                                                         |
 +-------------+-----------------------------------------------------------------------------+
 | Inherited   | - `by_reference`_                                                           |
@@ -363,6 +364,31 @@ rendering your form, having the entire "form row" may be easier for you.
 For details on how to actually use this option, see the above example as
 well as :ref:`cookbook-form-collections-new-prototype`.
 
+prototype_data
+~~~~~~~~~~~~~~
+
+.. versionadded:: 2.8
+    The ``prototype_data`` option was introduced in Symfony 2.8.
+
+**type**: ``mixed`` **default**: ``null``
+
+Allows you to define specific data for the prototype. Each new row added will
+initially contain the data set by this option. By default, the data configured
+for all entries with the ``entry_options`` option will be used.
+
+.. code-block:: php
+
+    use Symfony\Component\Form\Extension\Core\Type\CollectionType;
+    use Symfony\Component\Form\Extension\Core\Type\TextType;
+    // ...
+
+    $builder->add('tags', CollectionType::class, array(
+        'entry_type' => TextType::class,
+        'allow_add' => true,
+        'prototype' => true,
+        'prototype_data' => 'New Tag Placeholder',
+    ));
+
 prototype_name
 ~~~~~~~~~~~~~~
 
