From ce793d2218e03a31d6f98e55920270e09c57fcff Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Uwe=20Ja=CC=88ger?= <uwej711@googlemail.com>
Date: Tue, 23 Apr 2013 23:18:30 +0200
Subject: [PATCH] [Form] adjust collection example to data-property-name
 attribute

---
 cookbook/form/form_collections.rst   | 12 ++++++++----
 reference/forms/types/collection.rst |  6 ++++++
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/cookbook/form/form_collections.rst b/cookbook/form/form_collections.rst
index be64bb969b7..adb4de67aa4 100755
--- a/cookbook/form/form_collections.rst
+++ b/cookbook/form/form_collections.rst
@@ -347,7 +347,7 @@ On the rendered page, the result will look something like this:
 
 .. code-block:: html
 
-    <ul class="tags" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
+    <ul class="tags" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;" data-prototype-name="__name__">
 
 The goal of this section will be to use JavaScript to read this attribute
 and dynamically add new tag forms when the user clicks a "Add a tag" link.
@@ -390,7 +390,9 @@ The ``addTagForm`` function's job will be to use the ``data-prototype`` attribut
 to dynamically add a new form when this link is clicked. The ``data-prototype``
 HTML contains the tag ``text`` input element with a name of ``task[tags][__name__][name]``
 and id of ``task_tags___name___name``. The ``__name__`` is a little "placeholder",
-which you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``).
+which you'll replace with a unique, incrementing number (e.g. ``task[tags][3][name]``). 
+Since you can change this placeholder with the option "prototype_name" the actual name is 
+provided in the ``data-prototype-name`` attribute.
 
 .. versionadded:: 2.1
     The placeholder was changed from ``$$name$$`` to ``__name__`` in Symfony 2.1
@@ -403,13 +405,15 @@ one example:
     function addTagForm(collectionHolder, $newLinkLi) {
         // Get the data-prototype explained earlier
         var prototype = collectionHolder.data('prototype');
+        var prototypeName = collectionHolder.data('prototype-name');
 
         // get the new index
         var index = collectionHolder.data('index');
 
-        // Replace '__name__' in the prototype's HTML to
+        // Replace prototypeName in the prototype's HTML to
         // instead be a number based on how many items we have
-        var newForm = prototype.replace(/__name__/g, index);
+        var re = new RegExp(prototypeName, "g");
+        var newForm = prototype.replace(re, index);
 
         // increase the index with one for the next item
         collectionHolder.data('index', index + 1);
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
index ce4e438001f..3d32608e566 100644
--- a/reference/forms/types/collection.rst
+++ b/reference/forms/types/collection.rst
@@ -334,6 +334,12 @@ If you have several collections in your form, or worse, nested collections
 you may want to change the placeholder so that unrelated placeholders are not
 replaced with the same value.
 
+.. tip::
+
+    If you're rendering the entire collection field at once, then the prototype_name
+    is available on the ``data-prototype-name`` attribute
+    of the element (e.g. ``div`` or ``table``) that surrounds your collection.
+
 Inherited options
 -----------------