symfony · javiereguiluz · Jul 6, 2018 · Jul 5, 2018 · Jul 5, 2018 · Jul 5, 2018
diff --git a/reference/forms/twig_reference.rst b/reference/forms/twig_reference.rst
@@ -217,6 +217,28 @@ array).

    <option {% if choice is selectedchoice(value) %} selected="selected"{% endif %} ...>

+.. _form-twig-rootform:
+
+rootform
+~~~~~~~~
+
+This test will check if the current ``form`` does not have a parent form view.
+
+.. code-block:: twig
+
+    {# DON'T DO THIS: this simple check can't differentiate between a form having
+       a parent form view and a form defining a normal form field called 'parent' #}
+
+    {% if form.parent is null %}
+        {{ form_errors(form) }}
+    {% endif %}
+
+   {# DO THIS: this check is always reliable, even if the form defines a field called 'parent' #}
+
+    {% if form is rootform %}
+        {{ form_errors(form) }}
+    {% endif %}
+
 .. _`twig-reference-form-variables`:

 More about Form Variables

diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
@@ -750,6 +750,20 @@ selectedchoice
 Checks if ``selectedValue`` was checked for the provided choice field. Using
 this test is the most effective way.

+rootform
+~~~~~~~~
+
+.. code-block:: twig
+
+    {% if form is rootform %}
+
+``form``
+    **type**: ``FormView``
+
+Checks if the given ``form`` does not have a parent form view. This is the only
+safe way of testing it because checking if the form contains a field called
+``parent`` is not reliable.
+
 Global Variables
 ----------------
-Original file line number
+Diff line change
@@ -217,6 +217,28 @@ array).
         <option {% if choice is selectedchoice(value) %} selected="selected"{% endif %} ...>
+    .. _form-twig-rootform:
+    rootform
+    ~~~~~~~~
+    This test will check if the current ``form`` does not have a parent form view.
+    .. code-block:: twig
+        {# DON'T DO THIS: this simple check can't differentiate between a form having
+           a parent form view and a form defining a normal form field called 'parent' #}
             Copy link

  
      
    
  

  
      

  
    Contributor


      

  

  
    
      

      
            HeahDude
  

      

      

      


        Jul 6, 2018


      
    

  


        
      
  
  
  
    

    There was a problem hiding this comment.


  

 
  
    

    Choose a reason for hiding this comment

    
      The reason will be displayed to describe this comment to others. Learn more.
    

    
      
      


  


  
    
      - normal
+ nested
?
    
  
  


    

        
      
  
  
    
  
  
  
    
    Sorry, something went wrong.
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


          
      
  
    
    
            xabbuh reacted with thumbs up emoji
      
        
            
    All reactions
  


          
              
                👍
                  1 reaction
              
          
        
      
    

    



  
        
  
    
        
    
  


      
          
  
      
            Copy link

  
      
    
  

  
      

  
  Member


      

  

  
    
      

      
            xabbuh
  

      

      

      


        Aug 7, 2018


      
    

  


        
      
  
  
  
    

    There was a problem hiding this comment.


  

 
  
    

    Choose a reason for hiding this comment

    
      The reason will be displayed to describe this comment to others. Learn more.
    

    
      
      


  


  
    
      fixed in 640e8e5
    
  
  


    

        
      
  
  
    
  
  
  
    
    Sorry, something went wrong.
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


          
      
  
    
    
      
        
            
    All reactions
+        {% if form.parent is null %}
+            {{ form_errors(form) }}
+        {% endif %}
+       {# DO THIS: this check is always reliable, even if the form defines a field called 'parent' #}
+        {% if form is rootform %}
+            {{ form_errors(form) }}
+        {% endif %}
     .. _`twig-reference-form-variables`:
     More about Form Variables
-          Expand Down