वाई में फॉर्म डिजाइनर

हाय हायबय्यूज़री!

अधिकांश Yii परियोजनाओं में जो मैंने देखा था, प्रपत्रों के साथ काम सबसे सरल तरीके से आयोजित किया गया था, जहां प्रपत्र का प्रतिपादन ActiveForm विजेट के माध्यम से दृश्य फ़ाइल में निर्धारित किया गया था। हां, यह निश्चित रूप से उन जटिल रूपों के लिए उचित है जो टेम्पलेट में फिट होना मुश्किल है। लेकिन आज मैं फॉर्म डिजाइनर के बारे में बात करना चाहता हूं और दिखाता हूं कि हम इसका उपयोग कैसे करते हैं।

यदि आपके पास एक खराब विचार है कि एक फॉर्म डिजाइनर क्या है, तो मैं आपको पहले सलाह देता हूं कि आप प्रलेखन के संबंधित खंड www.yiiframework.ru/doc/guide/ru/form.builder के साथ खुद को परिचित कराएं ।

सब कुछ सरल है। रूपों के साथ कार्य "मॉडल और टेबल मॉडल को मिलाकर न करें" के सिद्धांत पर बनाया गया है। और फॉर्म डिजाइनर के लिए फॉर्म डिजाइनर की कार्यक्षमता को जोड़ने के लिए विचार है।

ऐसा करने के लिए, एक वर्ग बनाएं जिसमें से हमारे फॉर्म विरासत में मिलेंगे। यानी आइए फॉर्म के विन्यास के आधार पर रेंडरिंग का निर्धारण खुद फॉर्म मॉडल करें।

/** * FormModel. * * @author Andrey Nilov <nilov@glavweb.ru> * @copyright Copyright (c) 2007-2012 Glavweb.Soft, Russia. (http://glavweb.ru) */ class FormModel extends CFormModel { /** * Config of the form * @var array */ protected $_formConfig = array(); /** * Config of the form by default * @var array */ private $_defaultFormConfig = array( 'method' => 'post' ); /** * Class name of form * @var string */ protected $_formClass = 'CForm'; /** * Object of Form * @var Form */ private $_form = null; /** * Constructor * * @param string $scenario Name of the scenario that this model is used in * @return void */ public function __construct($scenario = '') { parent::__construct($scenario); $this->_setFormConfig(); } /** * Sets config of the form * * @return void */ private function _setFormConfig() { $this->_formConfig = array_replace_recursive( $this->_defaultFormConfig, $this->_formConfig() ); } /** * Returns config of the form * * @return array */ protected function _formConfig() { return $this->_formConfig; } /** * Returns the attribute labels * * @return array Attribute labels (name=>label) */ public function attributeLabels() { return $this->getLabels(); } /** * Returns the config of the form * * @return array */ public function getFromConfig() { return $this->_formConfig; } /** * Sets the config of the form * * @param array $config * @return void */ public function setFromConfig(array $config) { $this->_formConfig = $config; } /** * Returns labels * * @return array */ public function getLabels() { $labels = array(); if (!empty($this->_formConfig['elements'])) { foreach ($this->_formConfig['elements'] as $name => $data) { if (isset($data['label'])) { $labels[$name] = $data['label']; } } } return $labels; } /** * Returns object of Form * * @return Form */ public function getForm() { if ($this->_form === null) { $this->_form = new $this->_formClass($this->_formConfig, $this); } return $this->_form; } } 

अधिक विस्तार से कक्षा के माध्यम से चलते हैं। सरणी "$ _formConfig" आपको फ़ॉर्म के कॉन्फ़िगरेशन को निर्दिष्ट करने की अनुमति देता है। उदाहरण के लिए:

 /** * Config of the form * @var array */ protected $_formConfig = array( 'activeForm' => array( 'class' => 'CActiveForm', 'id' => 'registration_form', 'enableClientValidation' => true, 'clientOptions' => array( 'validateOnSubmit' => true ) ), 'elements' => array( .... 'name' => array( 'type' => 'text', 'label' => '' ), 'organization' => array( 'type' => 'text', 'label' => '' ), .... ), 'buttons' => array( 'register' => array( 'type' => 'submit', 'label' => '' ) ) ); 

आप फ़ॉर्म को कॉन्फ़िगर करने के लिए "_formConfig ()" विधि को भी ओवरराइड कर सकते हैं। यह सुविधाजनक है जब आपको कॉन्फ़िगरेशन के दौरान किसी प्रकार के तर्क को लागू करने की आवश्यकता होती है।

"$ _FormClass" संपत्ति आपको उस वर्ग को बदलने की अनुमति देती है जिसका उपयोग फ़ॉर्म (सीफ़ॉर्म या इसके वंशज) को प्रदर्शित करने के लिए किया जाता है।

ध्यान दें कि अब आपको फ़ॉर्म की विशेषताओं को निर्दिष्ट करने की आवश्यकता नहीं है। ऐसा करने के लिए, हमने विशेषता पूर्णांक () विधि को फिर से परिभाषित किया और अब विशेषताएँ प्रपत्र कॉन्फ़िगरेशन से लेबल के बराबर हैं।

आप "getForm ()" पद्धति का उपयोग करके फॉर्म ऑब्जेक्ट (CForm) प्राप्त कर सकते हैं।

का प्रयोग करें।

फार्म का प्रतिपादन:

 $formModel = new RegistrationForm(); $form = $formModel->getForm(); echo $form; 

तालिका मॉडल के साथ संयोजन में उपयोग करें।

 $user = new User(); $user->setAttributes($formModel->getAttributes()); $result = $user->save(); 

फॉर्म का प्रदर्शन कस्टमाइज़ करें। "$ _FormConfig" में प्रत्येक तत्व के लिए हम "लेआउट" संपत्ति को ओवरराइड करने के साथ अपने टेम्पलेट को निर्दिष्ट कर सकते हैं:

 protected $_formConfig = array( .... 'elements' => array( .... 'name' => array( 'type' => 'text', 'label' => '', 'layout' => "{input}\n{label}\n{hint}\n{error}" ), .... ), 

स्वचालित रूप से एक कोलन जोड़ें।

प्रपत्र डिज़ाइनर का उपयोग करते समय उत्पन्न होने वाली परेशानियों में से एक फ़ील्ड हेडर के बाद स्वचालित रूप से एक कोलोन जोड़ने में असमर्थता थी। यदि कोलन को लेबल में फॉर्म कॉन्फिगर में डाला जाता है, तो यह तब दिखाई देगा जब एरर दिखेंगे। इसे ठीक करने के लिए, हम “CForm” और “CFormInputElement” कक्षाओं का विस्तार करेंगे और अपने “FormModel” को थोड़ा संशोधित करेंगे।

"FormModel" में:

  /** * Automatically add a colon in time rendering * @var boolean */ public $autoAddColonForRender = true; 

और $ _formClass बदलें

  /** * Class name of form * @var string */ protected $_formClass = 'Form'; 

आइए एक नया वर्ग "फ़ॉर्म" और "CForm" के उत्तराधिकारी बनाएं, इसमें हम संपत्ति "$ inputElementClass" को ओवरराइड करेंगे।

 class Form extends CForm { /** * The name of the class for representing a form input element. * @var string */ public $inputElementClass = 'FormInputElement'; } 

चलो एक वर्ग "FormInputElement" ("CFormInputElement" का उत्तराधिकारी) बनाएं, इसमें हम "रेंडरलैबेल ()" विधि को फिर से परिभाषित करेंगे।

 class FormInputElement extends CFormInputElement { /** * @var string the layout used to render label, input, hint and error. They correspond to the placeholders * "{label}", "{input}", "{hint}" and "{error}". */ public $layout = "{label}\n{input}\n{error}\n{hint}"; /** * Automatically add a colon in time rendering * @var boolean */ public $addColon = null; /** * Renders the label for this input. * * @return string */ public function renderLabel() { $model = $this->getParent()->getModel(); $addColon = $this->addColon !== null ? $this->addColon : $model instanceof FormModel && $model->autoAddColonForRender; $label = $addColon ? $this->getLabel() . ':' : $this->getLabel(); $options = array( 'label' => $label, 'required' => $this->getRequired() ); if (!empty($this->attributes['id'])) { $options['for'] = $this->attributes['id']; } return CHtml::activeLabel($this->getParent()->getModel(), $this->name, $options); } } 

अब "FormModel" में संपत्ति "$ autoAddColonForRender" का उपयोग करके सभी फॉर्म तत्वों के लिए लेबल के बाद स्वचालित रूप से एक कोलोन जोड़ना संभव है। या प्रपत्र के कॉन्फ़िगरेशन के दौरान अलग-अलग फ़ॉर्म के प्रत्येक तत्व के लिए इसे परिभाषित करने के लिए, "एडकॉन" में संबंधित मान सेट करें।

  protected $_formConfig = array( .... 'elements' => array( .... 'name' => array( 'type' => 'text', 'label' => '', 'addColon' => true ), .... ), 

आज के लिए बस इतना ही, अंत तक पढ़ने वाले सभी को धन्यवाद। उद्देश्यपूर्ण आलोचना का स्वागत है।