[forms][collections] Changing how we access the prototype to be consistent with Symfony 2.1

weaverryan · weaverryan · commit 4084a8d02719 · 2012-07-02T22:20:49.000-05:00
Both the old and the new syntax work, but due to a BC break in 2.1, only the second is correct in 2.1. To add more consistency between the versions, we're documenting and recommending this change. This relates to symfony#1486
diff --git a/cookbook/form/form_collections.rst b/cookbook/form/form_collections.rst
@@ -307,7 +307,7 @@ new "tag" forms. To render it, make the following change to your template:
 
     .. code-block:: html+jinja
     
-        <ul class="tags" data-prototype="{{ form_widget(form.tags.get('prototype')) | e }}">
+        <ul class="tags" data-prototype="{{ form_widget(form.tags.vars.prototype) | e }}">
             ...
         </ul>
     
@@ -325,15 +325,15 @@ new "tag" forms. To render it, make the following change to your template:
 
 .. tip::
 
-    The ``form.tags.get('prototype')`` is form element that looks and feels just
+    The ``form.tags.vars.prototype`` is form element that looks and feels just
     like the individual ``form_widget(tag)`` elements inside our ``for`` loop.
     This means that you can call ``form_widget``, ``form_row``, or ``form_label``
     on it. You could even choose to render only one of its fields (e.g. the
     ``name`` field):
     
     .. code-block:: html+jinja
     
-        {{ form_widget(form.tags.get('prototype').name) | e }}
+        {{ form_widget(form.tags.vars.prototype.name) | e }}
 
 On the rendered page, the result will look something like this:
 
diff --git a/reference/forms/types/collection.rst b/reference/forms/types/collection.rst
@@ -146,7 +146,7 @@ you need is the JavaScript:
             {# ... #}
 
             {# store the prototype on the data-prototype attribute #}
-            <ul id="email-fields-list" data-prototype="{{ form_widget(form.emails.get('prototype')) | e }}">
+            <ul id="email-fields-list" data-prototype="{{ form_widget(form.emails.vars.prototype) | e }}">
             {% for emailField in form.emails %}
                 <li>
                     {{ form_errors(emailField) }}
@@ -295,7 +295,7 @@ collection field:
 
     .. code-block:: jinja
     
-        {{ form_row(form.emails.get('prototype')) }}
+        {{ form_row(form.emails.vars.prototype) }}
 
     .. code-block:: php
     
