form add extra data

Author: Arkalo2

forms.rst

@@ -940,6 +940,59 @@ These "unmapped fields" can be set and accessed in a controller with::
 Additionally, if there are any fields on the form that aren't included in
 the submitted data, those fields will be explicitly set to ``null``.
 
+Extra fields
+~~~~~~~~~~~~~~~
+
+All form fields are considered properties of the object but you can inject fields 
+directly into your view without specifying them in the form definition.
+They can be retrieved via the ``getExtraData`` :class:`Symfony\\Component\\Form\\FormTypeInterface`. 
+
+This is a creation user form::
+
+    // ...
+    use Symfony\Component\Form\Extension\Core\Type\CheckboxType;
+    use Symfony\Component\Form\Extension\Core\Type\SubmitType;
+    use Symfony\Component\Form\FormBuilderInterface;
+    use App\User;
+
+    class UserCreateType extends AbstractType
+    {
+        public function buildForm(FormBuilderInterface $builder, array $options): void
+        {
+            $builder
+                ->add('username', TextType::class)
+                ->add('email', EmailType::class)
+            ;
+        }
+
+        public function configureOptions(OptionsResolver $resolver)
+        {
+            $resolver->setDefaults([
+                'data_class' => User::class,
+            ]);
+        }
+    }
+
+The extra fields can be injected like this::
+
+    {# templates/user/create.html.twig #}
+    {{ form_start(form) }}
+        {{ form_row(form.username) }}
+        {{ form_row(form.email) }}
+
+        {# Hidden field to send additional sponsorship code #}
+        <input type="hidden" name="user_create[referralCode]" value="{{ referralCode }}" />
+
+        <button type="submit">Submit</button>
+    {{ form_end(form) }}
+
+Here, the sponsorship code is an extra field injected at view level.
+
+You can get the referraCode via ``getExtraData``:: 
+
+    $extraData = $form->getExtraData();
+    $referraCode = $extraData['referralCode'] ?? null;
+
 Learn more
 ----------