सिम्फनी 2 रूपों का विस्तार

प्रस्तावना

प्रपत्र यकीनन Symfony2 के सबसे जटिल घटकों में से एक हैं। लेकिन इसकी सारी जटिलता के पीछे एक उल्लेखनीय लचीली वास्तुकला निहित है जो विस्तार के लिए पर्याप्त जगह प्रदान करती है। डेवलपर्स के रूप में, हम फ़ॉर्म फ़ील्ड प्रकार जोड़ सकते हैं (बदल सकते हैं), इवेंट श्रोताओं, डेटा ट्रांसफ़ॉर्मरों और टाइप एक्सटेंशन का उपयोग कर सकते हैं। हम आज बाद के बारे में बात करेंगे।

सिद्धांत

प्रकार एक्सटेंशन फ़ील्ड प्रकारों के व्यवहार और प्रस्तुति (FormView) को बदलने के लिए एक शक्तिशाली तंत्र प्रदान करते हैं। एक्सटेंशन के भीतर, आवश्यक तर्क को लागू करने के लिए 4 प्रविष्टि बिंदु प्रदान किए जाते हैं:

public function buildForm(FormBuilderInterface $builder, array $options) { } public function buildView(FormView $view, FormInterface $form, array $options) { } public function finishView(FormView $view, FormInterface $form, array $options) { } public function setDefaultOptions(OptionsResolverInterface $resolver) { } 

आइए उन पर अधिक विस्तार से विचार करें:

1. बिल्डफ़ॉर्म - फॉर्मब्युल्ट ऑब्जेक्ट तक पहुंच प्रदान करता है, जो आपको फॉर्म फ़ील्ड को जोड़ने, संशोधित करने या हटाने की अनुमति देता है, साथ ही श्रोताओं को भी संलग्न करता है;
2. buildView - प्रपत्र की प्रस्तुति को संशोधित करने के लिए FormView और प्रपत्र ऑब्जेक्ट तक पहुँच प्रदान करता है। इस पद्धति के भीतर, बच्चे के विचारों को संशोधित करना संभव नहीं है;
3. finishView - buildView के समान, लेकिन आपको बच्चे के विचारों को बदलने की अनुमति देता है;
4. setDefaultOptions - विकल्पों की सूची का विस्तार करने या बदलने के लिए OptionsResolver ऑब्जेक्ट तक पहुंच प्रदान करता है।

ज्यादातर मामलों में, हम setDefaultOptions और buildView विधियों के साथ काम करेंगे। फ़ॉर्म एक्सटेंशन लागू करने के लिए सामान्य एल्गोरिदम में से एक:

1. setDefaultOptions - OptionsResolver में एक नया विकल्प पंजीकृत करें;
2. buildView - हम विकल्प मान को संसाधित करने के तर्क को लागू करते हैं और नए पैरामीटर को दृश्य में पास करते हैं;
3. पैरामीटर मान प्रदर्शित करने के लिए प्रपत्र टेम्पलेट बदलें।

GetExtendedType विधि हमें उन फ़ील्ड्स के प्रकार को नियंत्रित करने की अनुमति देती है जिनके लिए एक्सटेंशन लागू किया गया है:

 public function getExtendedType() { //        textarea return 'textarea'; } 

सिम्फनी 2 फ्रेमवर्क में एक्सटेंशन का उपयोग करने के लिए, यह विशेष टैग form.type_extension का उपयोग करके डिपेंडेंसी इंजेक्शन कंटेनर में एक सेवा के रूप में पंजीकृत होना चाहिए। टैग के लिए, आपको उन फ़ील्ड के प्रकार को इंगित करने वाले अन्य प्रकार को निर्दिष्ट करने की आवश्यकता है जिनके लिए एक्सटेंशन लागू किया जाएगा:

 services: acme_demo.form.my_extension: class: Acme\DemoBundle\Form\Extension\MyExtension tags: - { name: form.type_extension, alias: textarea } 

अभ्यास

उदाहरण के लिए, हम एक एक्सटेंशन लागू करते हैं जो आपको फ़ील्ड बनाने और उन्हें <फ़ील्डसेट> तत्व के अंदर प्रदर्शित करने की अनुमति देता है।

 <?php namespace Acme\DemoBundle\Form\Extension; use Symfony\Component\Form\AbstractTypeExtension; use Symfony\Component\Form\FormView; use Symfony\Component\Form\FormInterface; use Symfony\Component\OptionsResolver\OptionsResolverInterface; use Symfony\Component\OptionsResolver\Options; class FieldsetExtension extends AbstractTypeExtension { private $rootView; public function getExtendedType() { //        return 'form'; } public function setDefaultOptions(OptionsResolverInterface $resolver) { $resolver->setDefaults(array( //     . 'group' => null, )); } public function buildView(FormView $view, FormInterface $form, array $options) { $group = $options['group']; if (null === $group) { return; } $root = $this->getRootView($view); $root->vars['groups'][$group][] = $form->getName(); } public function getRootView(FormView $view) { $root = $view->parent; while (null === $root) { $root = $root->parent; } return $root; } } 

एक प्रपत्र टेम्पलेट बनाएँ:

 {# src Acme/DemoBundle/Resources/views/Form/fields.html.twig #} {% extends 'form_div_layout.html.twig' %} {% block form_widget_compound %} <div {{ block('widget_container_attributes') }}> {% if form.parent is empty %} {{ form_errors(form) }} {% endif %} {% if form.vars.groups is defined %} {% for group,items in form.vars.groups %} <fieldset> <legend>{{ group|title|trans({}, translation_domain) }}</legend> {% for item in items %} {{ form_row(form[item]) }} {% endfor %} </fieldset> {% endfor %} {% endif %} {{ form_rest(form) }} </div> {% endblock form_widget_compound %} 

निर्भरता कंटेनर में विस्तार दर्ज करने के बाद, आप इसका उपयोग शुरू कर सकते हैं। एक नया फॉर्म बनाएँ:

 <?php namespace Acme\DemoBundle\Form\Extension; use Symfony\Component\Form\AbstractType; use Symfony\Component\Form\FormBuilderInterface; use Symfony\Component\OptionsResolver\OptionsResolverInterface; class PersonType extends AbstractType { public function buildForm(FormBuilderInterface $builder, array $options) { $builder ->add('name', 'text', array( 'group' => 'fio' )) ->add('surname', 'text', array( 'group' => 'fio' )) ->add('midname', 'text', array( 'group' => 'fio' )) ->add('phone', 'text', array( 'group' => 'contacts' )) ->add('skype', 'text', array( 'group' => 'contacts' )) ->add('email', 'text', array( 'group' => 'contacts' )) ; } } 

और उसके लिए टेम्पलेट:

 {# src Acme/DemoBundle/Resources/views/Person/new.html.twig #} {% form_theme form 'AcmeDemoBundle:Form:fields.html.twig' %} <form action="{{ path('person_create') }}" > {{ form_widget(form) }} </form> 

इसलिए विस्तार काम करता है, लेकिन कार्यान्वयन मेरे हिसाब से सुविधाजनक नहीं है। आइए, थोड़ा सा संश्लिष्ट चीनी जोड़ने और जोड़ने की कोशिश करें। ऐसा करने के लिए, एक आवरण वर्ग बनाएँ:

 <?php namespace Acme\DemoBundle\Form; use Symfony\Component\Form\FormBuilder; class FormMapper { /** * Form builder * @var FormBuidler */ private $builder; /** * Active group * @var mixed null|string */ private $group = null; public function __construct(FormBuilder $builder) { $this->builder = $builder; } /** * Add child to builder with group option */ public function add($child, $type = null, array $options = array()) { if (!array_key_exists('group', $options) and null !== $this->group) { $options['group'] = $this->group; } $this->builder->add($child, $type, $options); return $this; } /** * Set active group */ public function with($group) { $this->group = $group; return $this; } } 

समूह प्रबंधन अब आसान है:

 public function buildForm(FormBuilderInterface $builder, array $options) { $mapper = new FormMapper($builder); $mapper ->with('fio') ->add('name', 'text') ->add('surname', 'text') ->add('midname', 'text') ->with('contacts') ->add('phone', 'text') ->add('skype', 'text') ->add('email', 'text') ; } 

अन्त

लेख तैयार करने में, निम्नलिखित सामग्रियों का उपयोग किया गया था:

1. सिम्फनी 2 फॉर्म घटक दस्तावेज
2. सिम्फनी 2 फॉर्म रेसिपी