Move Form Events article to the topic

wouterj · wouterj · commit 7ed978865d50 · 2016-07-13T15:56:31.000+02:00
diff --git a/form/dynamic_form_modification.rst b/form/dynamic_form_modification.rst
@@ -25,8 +25,7 @@ how to customize your form based on three common use-cases:
    field.
 
 If you wish to learn more about the basics behind form events, you can
-take a look at the :doc:`Form Events </components/form/form_events>`
-documentation.
+take a look at the :doc:`Form Events </form/events>` documentation.
 
 .. _cookbook-form-events-underlying-data:
 
diff --git a/form/events.rst b/form/events.rst
@@ -27,7 +27,7 @@ depending on the request values::
     };
 
     $form = $formFactory->createBuilder()
-        // add form fields
+        // ... add form fields
         ->addEventListener(FormEvents::PRE_SUBMIT, $listener);
 
     // ...
@@ -310,18 +310,22 @@ Creating and binding an event listener to the form is very easy::
 When you have created a form type class, you can use one of its methods as a
 callback for better readability::
 
-    // ...
+    // src/AppBundle/Form/SubscriptionType.php
+    namespace AppBundle\Form;
 
+    // ...
     class SubscriptionType extends AbstractType
     {
         public function buildForm(FormBuilderInterface $builder, array $options)
         {
-            $builder->add('username', 'text');
-            $builder->add('show_email', 'checkbox');
-            $builder->addEventListener(
-                FormEvents::PRE_SET_DATA,
-                array($this, 'onPreSetData')
-            );
+            $builder
+                ->add('username', 'text')
+                ->add('show_email', 'checkbox')
+                ->addEventListener(
+                    FormEvents::PRE_SET_DATA,
+                    array($this, 'onPreSetData')
+                )
+            ;
         }
 
         public function onPreSetData(FormEvent $event)
@@ -341,6 +345,9 @@ Event subscribers have different uses:
 
 .. code-block:: php
 
+    // src/AppBundle/Form/EventListener/AddEmailFieldListener.php
+    namespace AppBundle\Form\EventListener;
+
     use Symfony\Component\EventDispatcher\EventSubscriberInterface;
     use Symfony\Component\Form\FormEvent;
     use Symfony\Component\Form\FormEvents;
@@ -388,8 +395,9 @@ Event subscribers have different uses:
         }
     }
 
-To register the event subscriber, use the addEventSubscriber() method::
+To register the event subscriber, use the ``addEventSubscriber()`` method::
 
+    use AppBundle\Form\EventListener\AddEmailFieldListener;
     // ...
 
     $form = $formFactory->createBuilder()
diff --git a/redirection_map b/redirection_map
@@ -254,6 +254,7 @@
 /components/expression_language/index /components/expression_language
 /components/filesystem/introduction /components/filesystem
 /components/filesystem/index /components/filesystem
+/components/form/form_events /form/events
 /components/form/introduction /components/form
 /components/form/index /components/form
 /components/http_foundation/introduction /components/http_foundation
